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For a device that can fit in the palm of your hand, the Raspberry Pi has had 
a pretty colossal impact since its launch in 2012. In just a few short years it's 
changed the way computer science is taught in schools, it's been used in some 
amazing projects at Raspberry Jam events across the world, and it's inspired 
a new generation of coders to create and craft new gadgets. No matter your 
age or experience level, there's a Pi project for you, and in Practical Raspberry Pi 
Projects we're giving you everything you need to fire up your imagination and 
unleash your creativity. From hardware-based projects like building a Raspberry 
Pi-controlled car, through software projects like programming your own 
virtual assistant, all the way to advanced electronics projects that will see you 
transforming your Pi into a drum machine, car computer or quadcopter, we've got 
plenty here to keep you busy. All you need is your favourite $35 computer and a 
passion for making things! 
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8 10 practical 

Raspberry Pi projects 

Kick-start some amazing projects 

Hardware 

32 Make a Pi 2 desktop PC 

Use your Pi as a replacement PC 

36 How I made: PiKon 

Check out this SD-printed telescope 

38 Build a RasPi-controlled car 

Take control of a remote-controlled car 

44 How I made: robot arm 

Get to grips with a Pi-powered robot arm 

46 Make a Raspberry Pi HTPC 

Finally create a more powerful machine 

48 Make a tweeting wireless 
flood sensor 

Flood-proof your basement 

50 Build a Raspberry 
Pi-powered Bigtrak 

Control your own all-terrain vehicle 

54 How I made: PiPanther 

Battle your friends in augmented reality 

56 Make a digital 
photo frame 

Turn your Pi into a beautiful photo frame 


Watch these coders hack video goggles 



Build a Raspberry Pi 
Mineaoft console 

Create a fully functional games console 

How I made: Bullet Pi 

What happens when you link 48 Pis together? 
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Electronics y 

106 Build a Raspberry Pi 
car computer 

Make your own touchscreen navigator 

114 How I made: RasPiViv 

Investigate an environmental control system 

116 Make a RasPi sampler 

Build your own looping drum machine , 

120 Transform your Pi into a 
micro oscilloscope 

Transform your RasPi with BitScope Micro 

124 How I made: Pi Glove 2 

Control lights, send texts and more 

126 Assemble a Minecraft 
power move glove 

Enhance your game with this cool hack ( 

130 Build a complex 
LED matrix 

Program your own light system 

134 Add gesture control to 
your Raspberry Pi 

Easily add touch controls to your projects 

138 How I made: Joytone 

A new type of electronic keyboard 

140 Simulate traffic liahts 
using your breadboard 

Try your hand at hardware engineering 

142 Program a quadcopter 

Take to the skies with this gadget 

148 20RaspbenyPi 
hacking projects 

Repurpose everyday items 


Software 


72 Supercharge your Pi 

Get the most out of your Raspberry Pi 

76 Create your own digital 
assistant part 1 

Tell your computer what to do 

78 Create your own digital 
assistant part 2 

Continue this project by decoding audio 

80 Create your own digital 
assistant part 3 

Run the commands you're giving your Pi 

82 Run science experiments 
on the Expeyes kit 

Make use of this digital oscilloscope 

86 Monitor CPU temperature 
wHh Dizmo 

Access the Internet ofThings 

90 Forecast the weather with 
your Raspberry Pi 

Prepare yourself for the next big storm 

92 Print wirelessly with your 
Raspberry Pi 

Breathe new life into an old printer 

94 Remotely control your 
Raspber^ Pi 

Employ your Pi as a media centre 

96 Turn your Pi into a motion 
sensor with SimpleCV 

Implement facial recognition into your Pi 

98 Code a simple synthesiser 

Write a simple synthesiser using Python 
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10 PRACTICAL RASPBERRY PI PROJECTS 


From our time covering this incredible credit card- 
sized computer, it’s become clear there are two types 
of Raspberry Pi owners: those that use theirs and those 
that don’t. Whether it’s fear of the unknown, a lack of time 
or inspiration, when we ask people what they do with their 
Pi we’ll often hear that it’s still in the box. If that’s you, then 
you’re in the right plaoe. In this feature we've handcrafted ten 
Raspberry Pi projects practically anyone can enjoy. 

These aren’t just a random selection of side-projects, though. 
These are practical ideas designed to help kick-start bigger 
and better things. Knowledge gained from one project can also 
be applied to another to create something completely new. For 
example, you could combine our Twitter and three-colour lamp 
tutorials to create a desk lamp that changes colour as your 
Twitter account is retweeted. You could go on to make Pong in 
Minecraft-Pi or use a button attached to Scratch to take photos 
with your Raspberry Pi camera module. The list goes on. 

All these projects are open source, so you’re encouraged to 
tweak and develop them into something entirely new. If you 
share yourtweaks and changes with the community, you’re sure 
to start benef ittingfrom doing things the open source way. . . 
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Make music with 
the Raspberry Pi 

Program your own melodies using Sonic Pi and create 
musical cues or robot beeps 


What yoi/l need 

■ Portable speakers 

■ Sonic Pi 

www.cl. cam. ac.uk/projects/ 
raspberrypi/sonicpi/teaching.html 


One of the major features of Scratch is 
its ability to teach the fundamentals 
of coding to kids and people with no 
computing background. For kids, its 
especially appealing due to the way it 
allows them to create videogames to 
interact with as part of their learning. In 
this kind of vein then, Sonic Pi teaches 
people to code using music. With a 
simple language that utilises basic logic 
steps but in a more advanced way than 
Scratch, it can either be used as a next 
step for avid coders, or as a way to create 
music for an Internet of Things or a robot. 


Getting Sonic Pi 

I If you’ve installed the latest version of Raspbian, Sonic 
Pi will be included by default. If you’re still using a slightly older 
version, then you’ll need to install it via the repos. Do this with: 

I $ sudo apt-get install sonic-pi 






MAKE MUSIC WITH THE RASPBERRY PI 


We can start making more 
complex melodies by using more 
of Sonic Pi’s functions 


starting with Sonic Pi 

Sonic Pi is located in the Education category in the 
menus. Open it up and you'll be presented with something that 
looks li ke an I DE. The pane on the left allows you to enter the code 
for your project, with proper syntax highlighting for its own style 
of language. When running, an info pane details exactly what's 
being played via Sonic Pi - and any errors are listed in their own 
pane as well, for reference. 




M Set the beat 

Eor any piece of music, you'll want to set the tempo. We 
can start by putting: 

I with_tempo 200 

. . .at the start of ou r code. We can test it out by creating a stri ng of 
midi notes using play_pattern: 

I play_pattern [40,25,45,25,25,50,50] 

This will play pretty_bell notes at these tones at the tempo we’ve 
set. You can create longer and shorter strings, and also change 
the way they play. 


Yourfirstnote 

Our first thing to try on Sonic Pi is simply being able 
to play a note. Sonic Pi has a few defaults preset, so we can get 
started with: 

I play 50 

Press the Play button and the output window will show you what’s 
being played. The pretty_bell sound is the default tone for Sonic 
Pi's output, and 50 determines the pitch and tone of the sound. 


Full code listing 

with_tempo 200 

play_pattern [40,25,45,25,25,50,50] 

2. times do 

with_synth “beep” 

play_pattern [40,25,45,25,25,50,50] 

play_pattern [40, 25, 45, 25, 25, 50, 50]. reverse 

end 


play_pad “saws”, 3 


in_thread do 

with_synth “fm” 

6. times do 

if rand < 0.5 

play 30 

else 


end 


play 50 
end 

sleep 2 


end 


2. times do 

play_synth “pretty_beH” 
play_pattern [40,25,45,25,25,50,50] 
play_pattern [40, 25, 45, 25, 25, 50, 50]. reverse 
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Advance your melody 

We can start making more complex melodies by using 
more of Sonic Pi’s functions. You can change the note type by 
using with_synth, reverse a pattern, and even create a finite loop 
with the x.times function; do and end signify the start and end 
of the loop. Everything is played in sequence before repeating, 
much like an if or while loop in normal code. 



Playing a concert 

Using the in_thread function, we can create another 
thread for the Sonic Pi instance and have several lines of musical 
code play at once instead of in sequence. We’ve made it create 
a series of notes in a random sequence, and have them play 
alongside extra notes created by the position and velocity of the 
mouse usingthe play_pad function. 


Youli 

learn... 



1. How 
to code 

The coding 
style of Sonic Pi 
uses concepts 
from standard 
programming 
languages - if 
statements, loops, 
threads etc. Whereas 
Scratch teachesthis 
logic, Sonic Pi teaches 
their structure. 

2. Robotic 
voice 

Employ Sonic Pi 
to create context- 
sensitive chips, chirps 
and beeps and use 
itto giveafamiliar 
voice while ittootles 
around. 

3. MIDI 

The Musical 
Instrument Digital 
Interface is a 
standard for digital 
music, and the 
numbers and tones 
used in Sonic Pi make 
use of this. 
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Raspberry Pi 
voi^ synHiesizer 

Add the power of speech to your Rospberiy Pi 
projects with the versatile eSpeak Python liorary 


What youl need 

■ Portable USB speakers 

■ python-espeak module 
■eSpeak 

■ Raspbian (latest image) 


We’ve shown in previous issues how 
the Raspberry Pi can be used to 
power robots, and as a tiny computer 
it can also be the centre of an Internet 
of Things in your house or office. 
For these reasons and more, using 
the Raspberry Pi for text-to-voice 
commands could be just what you're 
looking for. Due to the Debian base 
of Raspbian, the powerful eSpeak 
library is easily available for anyone 
looking to make use of it. There's also a 
module that allows you to use eSpeak 
in Python, going beyond the standard 
command-line prompts so you can 
perform automation tasks. 



Everything you’ll need 

I We’ll install everything we plan to use in this tutorial at 
once. This includes the eSpeak library and the Python modules 
we need to show it off. Open the terminal and install with: 

I $ sudo apt-get install espeak python-espeak python-tk 




RASPBERRY PI VOICE SYNTHESIZER 


You can change the way eSpeak 
will read text with a number of 
different options 



Pi’s first words 

The eSpeak library is pretty simple to use - to get it to 
just say something, type in the terminal: 

I $ espeak “[message]” 

This will use the library's defaults to read whatever is written in 
the message, with decent clarity. 


Say some more 

You can change the way eSpeak will read text with a 
number of different options, such as gender, read speed and 
even the way it pronounces syllables. For example, writing the 
command like so: 

I $ espeak -ven+f3 -k5 -sl50 “[message]” 

. . .will turn the voice female, emphasise capital letters and make 
the reading slower. 




A voice synthesiser 

Using the code listing, we're creating a simple interface 
with Tkinter with some predetermined voice buttons and a 
custom entry method. We're showing how the eSpeak module 
can be manipulated to change its output. This can be used for 
readingtweets or automated messages. Flavefun! 


Full code listing 


Import the 
necessary eSspeak 
and GUI modules, as 
well as the module 
to find out the time 


from espeak import espeak 

from Tkinter import * 

from datetime import datetime 

def hello_world(): 

espeak. synth(“Hello World”) 



Define the different 
functions that the 
interface will use, 
includinga simple 
fixed message, 
tellingthe time, and 
a custom message 


def time_now(): 

t = datetime. now().strftime(“%k %M”) 
espeak. synth(“The time is %s”%t) 

def read_text(): 

text_to_read = input_text.get() 
espeak. synth(text_to_read) 


Create the basic 
window with Tkinter 
foryour interface, 
as well as creating 
the variable for 
text entry 


root = Tk() 

root.title(“Voice box”) 
input.text = StringVar() 

box = Frame(root, height = 200, width = 500) 

box.pack_propagate(0) 

box.pack(padx = 5, pady = 5) 


M Taking command with Python 

The most basic way to use eSpeak in Python is to use 
subprocess to directly call a command-line function. Import 
subprocess in a Python script, then use: 

I subprocess. call([“espeak”, “[options 1]”, “[option 
2]”,... ’’[option n]”, “[message]”) 

The message can be taken from a variable. 


The native tongue 

The Python eSpeak module is quite simple to use to Just 
convert some text to speech. Try this sample code: 

■ from espeak import espeak 
espeak. synth(“[message]”) 

You can then incorporate this into Python, like you would any 
other module, for automation. 


The text entry 
appends to the 
variable we 
created, and each 
button calls a 
specific function 
that we defined 
above in the code 


Label(box, text=”Enter text”).pack() 
entry_text = Entry(box, exportselection = 0, 
textvariable = input_text) 
entry_text.pack() 

entry_ready = Button(box, text = “Read this”, 
command = read_text) 
entry_ready. pack() 

hello_button = Button(box, text = “Hello World”, 

command = hello_world) 

hello_button.pack() 

time_button = Button(box, text = “What’s the 
time?”, command = time_now) 
time_button.pack() 


root.mainloopO 
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Program 

Minecroff-Pi 


Learn to program while playing one of the 
greatest gomes ever mode! 


What youl need 

■ Raspbian (latest release) 

■ Minecraft-Pi tarball 

■ Keyboard & mouse 

■ Internet connection 


Minecraft is probably the biggest game 
on the planet right now. It's available on 
just about any format you can imagine, 
from PCs to gaming consoles to mobile 
phones. It should probably come as 
no surprise that it’s also available on 
the Raspberry Pi. While at first glance 
Minecraft-Pi is a simplified version of the 
Pocket Edition (designed for tablets and 
smartphones), the Raspberry Pi edition 
is very special, in that it's the only version 
of Minecraftto gives users access to its 
API (application programming interface). 

In this project we're going to show you 
howto setup Minecraft-Pi and configure 
it so you can interact with Minecraft in a 
way you’ve never done before. This small 
project is Just the tip of the iceberg. . . 


Download Pi Edition nowl 


MfNECRHFT 

‘pt buttoh; 
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Requirements 

I Minecraft-Pi requires you to be running Raspbian on 
your Raspberry Pi, so if you’re not already running that, take a 
trip to raspberrypi.org and get it setup. It also requires you have 
X Window loaded too. Assuming you’re at the command prompt, 
you Just need to type startx to reach the desktop. 


■ Unlike all other 
versions of Minecraft, 
the Pi version 
encourages you to 
hack it 



MfffECRHFT 



r 



PROGRAM MINECRAFT-PI 


Installation 

Make sure you're already in your 
home folder and download the Minecraft- 
Pi package with the following commands 
in aterminal window: 

I cd ~ 

wget https://s3.amazonaws.com/ 
assets. minecraft . net/ 
pi/minecraf t-pi-0. 1 . 1 .tar. gz 
To use it we need to decompress it. Copy 
the following into the terminal window: 

I tar -zxvf minecraft-pi-0.1.1.tar.gz 
Now you can move into the newly 
decompressed Mineoraft-Pi directory 
and try running the game for the first time: 

I cd mcpi 

./minecraft-pi 


Playing Minecraft-Pi 

Have a look around the game. 
If you’re not familiar with Minecraft, you 
control movement with the mouse and 
the WASD keys. Numbers 1-8 select items 
in your quickbar, the space bar makes you 
jump and Shift makes you walk slowly (so 
you don’t fall off edges). ‘E’ will open your 
inventory and double-tapping the space 
bar will also toggle your ability to fly. 


M Configuring the Python API 

To take control of Minecraftw'ith 
the Python API, you next need to copy the 
Python API folder from within the /mcpi 
folder to a new location. In the terminal, 
type the following: 

I cp -I — /mcpi/api/python/mcpi 
-/ minecraft 

In this folder, we want to create a 
‘boilerplate’ Python document that 
connects the API to the game. Write the 
following into the terminal: 

I cd -/minecraft 
nano minecraft. py 

With nano open, copy the following and 
then save and exit with Ctrl+X, pressing 
Y (for yes), then Enter to return to the 
command prompt: 

from mcpi. minecraft import 
Minecraft 

from mcpi import block 
from mcpi.vec3 import Vec3 
me = Minecraft. createO 
mc.postToChat(“Minecraft API 
Connected”) 


Testingyour Python script 

The short script you created 
contains everything you need to get 
started with hacking Minecraft-Pi in the 
Python language. For it to work, you need 
to have the game already running (and 
be playing). To grab control of the mouse 


Full code listing 

# ! /usr/bin/env python 

from mcpi. minecraft import Minecraft 
from mcpi import block 
from mcpi.vecS import Vec3 
from time import sleep, time 
import random, math 

me = Minecraft. createO # make a connection to the game 
playerPos = me. player. getPos() 

# function to round players float position to integer position 
def roundVec3(vec3) : 

return Vec3(int(vec3.x), int(vec3.y), int(vec3.z)) 

# function to quickly calc distance between points 
def distanceBetweenPoints(pointl, point2): 

xd = point2.x - pointl.x 
yd = point2.y - pointl.y 
zd = point2.z - pointl.z 

return math. sqrt((xd*xd) + (yd*yd) + (zd*zd)) 



Youli 

learn... 



Functional, & 
fun coding 

There’s nothingtoo 
taxing about our 
code. We’ve created 
acouple of simple 
functions (starting 
with def) and used 
if, else and while to 
create the logic. 


def random_block() : # create a block in a random position 
randomBlockPos = roundVec3(playerPos) 

randomBlockPos.x = random. randrange(randomBlockPos.x - 50, randomBlockPos. x + 50) 
randomBlockPos. y = random. randrange(randomBlockPos.y - 5, randomBlockPos. y + 5) 
randomBlockPos. z = random. randrange(randomBlockPos.z - 50, randomBlockPos. z + 50) 
return randomBlockPos 


def main(): # the main loop of hide & seek 
global lastPlayerPos, playerPos 
seeking = True 
lastPlayerPos = playerPos 

randomBlockPos = random_block() 

me. setBlock(randomBlockPos, block. DIAMOND_BLOCK) 

mc.postToChat(“A diamond has been hidden somewhere nearby 1”) 

lastDistanceFromBlock = distanceBetweenPoints(randomBlockPos, lastPlayerPos) 
timeStarted = time() 
while seeking: 

# Get players position 
playerPos = me. player. getPos() 

# Has the player moved 

if lastPlayerPos 1= playerPos: 

distanceFromBlock = distanceBetweenPoints(randomBlockPos, playerPos) 

if distanceFromBlock < 2: 

#found itl 
seeking = False 
else: 

if distanceFromBlock < lastDistanceFromBlock: 

mc.postToChat(“Warmer “ + str(int(distanceFromBlock)) + “ blocks away”) 
if distanceFromBlock > lastDistanceFromBlock: 

mc.postToChat(“Colder “ + str(int(distanceFromBlock)) + “ blocks away”) 

lastDistanceFromBlock = distanceFromBlock 

sleep(2) 

timeTaken = time() - timeStarted 

mc.postToChat(“Well done - “ + str(int(timeTaken)) + “ seconds to find the diamond”) 

if name == “ main ”: 

main() 


while in-game, you can press Tab. Open a 
fresh terminal window, navigate into your 
minecraft folder and start the script with 
thefollowing commands: 

i cd -/minecraft 
python minecraft. py 
You’ll see a message appear on screen to 
let you know the API connected properly. 
Now we know it works, let’s get coding! 


Hide & Seek 

As you can see from the code above, we’ve created a 
game of Hide & Seek adapted from Martin O’Hanlon's original 
creation (which you can find on www.stuffaboutcode.com). 
When you launch the script, you’ll be challenged to find a 
hidden diamond in the fastest time possible. We’ve used it to 
demonstrate some of the more accessible methods available in 
the API. But there’s much more to it than this demonstrates. Stay 
tuned -we’ll be back with more related guides in future issues. 
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Get interactive 
with Scratch 


Experiment with physical computing by using Scratch to 
interact with buttons and lights on your Pi 


What yoi/l need 

■ Breadboard 

■ LEDs 

■ Buttons 

■ Resistors 

■ Jumper wires 

■ ScratchGPIOS 


Scratch is a very simple visual 
programming language, commonly 
used to teach basic programming 
concepts to learners of any age. In 

this project we’ll learn how to light up 
an LED when a button is pressed in 
Scratch, and then change a character’s 
colour when a physical button is 
pressed. With these techniques 
you can make all manner of fun and 
engaging projects, from musical 
keyboards to controllers for your 
Scratch games and animations. 


Installingthe required software 

I Log into the Raspbian system with the username Pi and 
the password raspberry. Start the LXDE desktop environment 
using the command startx. Then open LXTerminal and type the 
following commands: 

I wget http://liamfraser.co.uk/lud/install_scratchgpio3.sh 
chmod +x install_scratchgpio3.sh 
sudo bash install_scratchgpio3.sh 
This will create a special version of Scratch on your desktop 
called ScratchGPI03. This is a normal version of Scratch 
with a Python script that handles communications between 
Scratch and the GPIO. ScratchGPIO was created by simplesi 
(cymplecy.wordpress.com). 



GET INTERACTIVE WITH SCRATCH 



Connectingthe breadboard 

Power off your Pi and disconnect the power cable. Get 
your breadboard, an LED, a 330-ohm resistor and two GPIO 
cables ready. You’ll want to connect the 3.3V pin (top-right pin, 
closest to the SD card) to one end of the 330-ohm resistor, and 
then connect the positive terminal of the LED (the longer leg is 
positive) to the other end. The resistor is used to limit the amount 
of current that can flow to the LED. 

Then put the negative terminal of the LED into the negative 
rail of the breadboard. Connect one of the GROUND pins (for 
example, the third pin from the right on the bottom row of pins) 
to the negative lane. Now connect the power to your Pi. The LED 
should light up. If it doesn’t, then it’s likely that you’ve got it the 
wrong way round, so disconnect the power, swap the legs around 
and then try again. 


SwitchingtheLEDonandoff 

At the moment, the LED is connected to a pin that 
constantly provides 3.3V. This isn’t very useful if we want to be able 
to turn it on and off, so let’s connect it to GPI0 17, which we can turn 
on and off GPI0 17 is the sixth pin from the right, on the top row of 
pins. Power the Pi back on. We can turn the LED on by exporting 
the GPIO pin, setting it to an output pin and then setting its value 
to 1. Settingthevalueto Oturns the LED backoff: 

I echo 17 > /sys/class/gpio/export 
echo out > /sys/class/gpio/gpiol7/direction 
echo 1 > /sys/class/gpio/gpiol7/value 
echo 0 > /sys/class/gpio/gpiol7/value 


when SprUiel clicked 
broadcast 
wait O secs 
broadcast pinlloff 


M Controlling the LED from Scratch 

Start the LXDE desktop environment and open 
ScratchGPI03. Go to the control section and create a simple script 
that broadcasts pinllon when Spritel is clicked. Then click the 
sprite. The LED should light up. Then add to the script to wait 1 
second and then broadcast pinlloff If you click the sprite again, 
the LED will come on for a second and then go off. ScratohGPI03 


uses pin numbers rather than GPIO numbers to identify pins. 
The top-right pin (the 3.3V we first connected our LED to) is pin 
number 1 , the pin underneath that is pin number 2, and so on. 




Wiring up our push button 

Power off the Pi again. This circuit is a little bit more 
complicated than the LED one we created previously. The first 
thing we need to do is connect 3.3V (the top-right pin we used to 
test our LED) to the positive rail of the breadboard. Then we need 
to connect a lOKohm resistor to the positive rail, and the other end 
to an empty track on the breadboard. Then on the same track, add 
a wire that has one end connected to GPIO 4. This is two pins to the 
right of GPI0 17. Then, on the same track again, connect one pin of 
the push button. Finally, connect the other pin of the push button 
to ground by adding a wire that is connected to the same negative 
rails that ground is connected to. 

When the button is not pressed, GPIO 4 will be receiving 3.3V. 
However, when the button is pressed, the circuit to ground will be 
completed and GPIO 4 will be receiving OV (and have a value of 0), 
because there is much less resistance on the path to ground. 

We can see this in action by watching the pin’s value and then 
pressingthe button to make it change: 

I echo 4 > /sys/class/gpio/export 
echo in > /sys/class/gpio/gpio4/direction 
watch -n 0.5 cat /sys/class/gpio/gpio4/value 
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Let there be light! 

Boot up the Pi and start ScratchGPI03 as before. Go 
to the control section and add when green flag clicked, then 
attach a forever loop, and inside that an if else statement. Go 
to the operators section and add an if [] = [] operator to the 
if statement. Then go to the sensing section and add a value 
sensor to the left side of the equality statement, and set the 
value to pin7. On the right side of the equality statement, enter 
0. Broadcast pinllon if the sensor value is 0, and broadcast 
pinlloff otherwise. Click the green flag. If you push the button, 
the LED will light up! 



You’ll 

learn... 



1. Simple 
circuits 

While these are very 
simple circuits, you’ll 
get a great feel of 
how the Raspberry 
Pi interfaces with 
basic prototyping 
kit. If you need to buy 
the bits and pieces, 
we recommend you 
checkout: 
shop.pimoroni.com 

2. Coding 
principles 

If you’re new to 
programming, 
Scratch is the 
perfect place to 
learn the same 
programming 
principles employed 
by all programming 
languages. 

3. Physical 
computing 

There’s nothing more 
magical than taking 
code from your 
computer screen 
and turning it into a 
real-life effect. Your 
first project might 
Justturnalighton 
and off, but with that 
skill banked, the sky 
isthe limit. 




Build a Raspberry Pi 
Webserver 


Use Google Coder to turn your Raspberry Pi into a tiny, 
low-powered web server and web host 


What yoi/l need 

■ Internet connectivity 

■ Web browser 

■ Google Coder 

googlecreativelab.github.io/coder/ 

raspberrypi/sonicpi/teaching.htnnl 


We’re teachingyou howto code in many 
different ways on the Raspberry Pi, so 
it only seems fitting that we look at the 
web too. 

There’s a new way to use the web on 
the Raspberry Pi as well; internet giant 
Google has recently released Coder 
specifically for the tiny computer. It’s a 
Raspbian-based image that turns your Pi 
into a web server and web development 
kit. Accessible easily over a local network 
and with support for jQuery out of the 
box, it’s an easy and great way to further 
your web development skills. 


Get Google Coder 

I Head to the Google Coder website, and download the 
compressed version of the image. Unpack it wherever you wish, 
and install it using dd, like any other Raspberry Pi image: 

I $ dd if=[path to]/raspi.irrg of=/dev/[path to SD 
card] bs=lM 




BUILD A RASPBERRY PI WEB SERVER 



Plug in your Pi 

For this tutorial, you’ll only need to connect a network 
cable into the Pi. Pop in your newly written SD card, plug in the 
power and waitafew moments. Ifyou’ve got a display plugged in 
anyway, you’ll notice a Raspbian startup sequence leading to the 
command-line login screen. 


Connect to Coder 

Open up the browser on your main system, and go to 
http://coder.local. You may have to manually accept the licence. 
It will ask you to set up your password, and then you’ll be in and 
ready to code. 




M Language of the web 

Now it’s time to create your own app or website. Click 
on the '+’ box next to the examples, give your app a name and 
then click Create. You’ll be taken to the FITM L section of the app. 
Change the Flello World lines to: 

<hl>This is a HTML header</hl> 

<p>This is a new block of default text</p> 





Full code listing 

HTML 


Some simple HTML 
code that can 
point us to some 
important websites. 
The h2 tag is used 
todisplaythetime 
thanks to Java 


<hl>Welcome to the internet. . .</hl> 

<h2></h2> 

<p><a href=”http://www.linuxuser.co.uk”>Linux ^ User & 
Developer</p> 

<p><a href=”http://www.reddit.com/”>Reddit</p> 

<p><a href=”http://www.linuxfoundation.org/”>The ^ 
Linux Foundation</p> 

<p><a href=”http://www.fsf.org/”>Free Software ^ 
Foundation</p> 


We’re callingthe 
current time using 
jQueryintheJS 
tab so that we can 
ultimately display it 
on the webpage 


We’re goingto 
display the time asa 
12-hourclockinthe 
first if statement, 
and use AM and PM 
to differentiate 
the time 


We make the 
minutes readable 
by adding a 0 if 
it’s below 10, then 
concatenate all 
the variables and 
assign to the tagh2 


Java 

van d = new Date; 

van hours = d.getHours(); 
van mins = d.getMinutes(); 
if (hours > 12) { 

var hour = (hours - 12); 
var ampm = “PM”; 

} 

else { 

var hour = hours; 
var ampm = “AM”; 

} 

if (hours == 12) { 
var ampm = “PM”; 

} 

if (mins > 9){ 

var min = mins; 

} 

else { 

var min = “0” + mins; 

} 

var time = “The time is “ + hour + 
+ “ “ + ampm; 

$(“h2”).html(time); 



+ min 
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Styled to impress 

Click on the CSS tab. This changes the look and style of 
the webpage without havingto make the changes each time in the 
main code. You can change the background colour and font with: 

I body { 

background-color: #000000; 
color: #ffffff; 


Querying your Java 

The third tab allows you to edit the jQuery, making 
the site more interactive. We can make it create a message on 
click with: 

I $(document).click(functionO { 

alert(‘You clicked the website!’); 
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Gxleyour 
own Iwitler bot 


Create your very own Twitter bot that can retweet chunks 
of wisdom from Linux User & Developer 


What yoi/l need 

■ Internet connectivity 

■ Latest version of Raspbian 

www.raspberrypi.org/ 

downloads 


Twitter is a useful way of sharing 
information with the world and it’s 
our favourite method of giving our 
views quickly and conveniently. Many 
millions of people use the microblogging 
platform from their computers, mobile 
devices and possibly even have it on 
their televisions. 

You don’t need to keep pressing that 
retweet button, though. With a sprinkling 
of Python, you can have your Raspberry 
Pi do it for you. Here's how to create your 
own Twitter bot... 


Installingthe required software 

1 Log into the Raspbian system with the username Pi and 
the password raspberry. Get the latest package lists using 
the command sudo apt-get update. Then install the Python 
Package installer using sudo apt-get install python-pip. 
Once you've done that, run sudo pip install twython to install 
the Twitter li brary we’ll be using. 


Registering with Twitter 

We need to authenticate with Twitter using OAuth. 
Before this, you need to go to https;//dev.twitter.com/apps and 
sign in with the account you’d like your Pi to tweet from. Click 
the ‘Create a new application’ button. We called our application 




CODE YOUR OWN TWITTER BOT 


‘LUD Pi Bot', gave it the same description and set the Website to 
http://www.linuxuser.co.uk/. The Callback URL is unnecessary. 
You’ll have to agree with the developer rules and then click the 
Create button. 


Creating an access token 

Go to the Settings tab and change the Access type 
from ‘Read only' to ‘Read and Write’. Then click the ‘Update 
this Twitter application’s settings’ button. The next step is to 
create an access token. To do that, click the ‘Create my access 
token’ button. If you refresh the details page, you should have 
a consumer key, a consumer secret and access token, plus an 
access token secret. This is everything we need to authenticate 
with Twitter. 


t ifthe tweet’s time is newer than 
the time the function was last 
called, we retweet it 

Retweeting a user 

The first thing we need to do is get a list of the user’s 
latest tweets. We then loop through each tweet and get its 
creation time as a string, which is then converted to a datetime 
object. We then check that the tweet’s time is newer than the 
time the function was last called - and if so, retweet the tweet. 


Authenticating with Twitter 

We’re going to create our bot as a class, where we 
authenticate with Twitter in the constructor. We take the tokens 
from the previous steps as parameters and use them to create 
an instanceoftheTwython API. Wealso have a variable, last_ran, 
which is set to the current time. This is used to check if there are 
new tweets later on. 


The main section 

The main section is straightforward. We create an 
instance of the bot class using our tokens, and then go into an 
infinite loop. In this loop, we check for any new retweets from 
the users we are monitoring (we could run the retweet task with 
different users), then update the time everything was last run, 
and sleep forfive minutes. 




Full code listing 



#! /usr/bin/env python2 

# A Twitter Bot for the Raspberry Pi that retweets any 
content from 

# @LinuxUserMag. Written by Liam Fraser for a Linux User & 
Developer article. 

import sys 
import time 

from datetime import datetime 
from twython import Twython 

class bot: 

def init (self, c_key, c_secret, a_token, a_token_ <-i 

secret) : 

# Create a Twython API instance 

self.api = Twython(c_key, c_secret, a_token, 
a_token_secret) 

# Make sure we are authenticated correctly 
try: 

self.api . verify_credentials() 
except: 

sys. exit (“Authentication Failed”) 
self . last_ran = datetime. now() 

@staticmethod 

def timestr_to_datetime(timestr) : 

# Convert a string like Sat Nov 09 09:29:55 +0000 

# 2013 to a datetime object. Get rid of the timezone 

# and make the year the current one 

timestr = “{0} {1}” . format(timestr[ : 19] , datetime. 
now() .year) 

# We now have Sat Nov 09 09:29:55 2013 

return datetime. strptime(timestr, ‘%a %b %d %H:%M: 

%S %Y’) 

def retweet_task(self , screen_name) : 

# Retweets any tweets we’ve not seen 


# from a user 

print “Checking for new tweets from @{0}”. 

format (screen_name) 

# Get a list of the users latest tweets 
timeline = self .api.get_user_timeline 

(screen_name = screen_name) 

# Loop through each tweet and check if it was 

# posted since we were last called 
for t in timeline: 

tweet_time = bot.timestr_to_datetime 
(t[‘created_at’]) 

if tweet_time > self . last_ran : 

print “Retweeting {0}” .format(t[‘ id’ ]) 
self .api . retweet(id = t[‘id’]) 

if name == “ main ”: 

# The consumer keys can be found on your application’s 

# Details page located at https://dev.twitter.com/ 

# apps(under “OAuth settings”) 
c_key=”” 

c_secret=”” 

# The access tokens can be found on your applications ’s 

# Details page located at https://dev.twitter.com/apps 

# (located under “Your access token”) 
a_token=”” 

a_token_secret=”” 

# Create an instance of the bot class 

twitter = bot(c_key, c_secret, a_token, a_token_secret) 

# Retweet anything new by SLinuxUserMag every 5 minutes 
while True: 

# Update the time after each retweet_task so we’re 

# only retweeting new stuff 
twitter. retweet_task(“LinuxUserMag”) 
twitter. last_ran = datetime. now() 
time.sleep(5 * 60) 
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ram your Arduino 
Raspberry Pi 


Enjoy all the features and benefits of fhe Arduino 
microconfroller on your Raspberry Pi projects 


What youl need 

■Arduino Uno 

■ Internet connectivity 

■ Nanpy 

https://github.com/nanpy 


You might be wondering why you might want to attach an 
Arduino to your Raspberry Pi. While there are lots of reasons, 
probably the most poignant is the extra six PWM-capable 
pins and another six analogue pins that a standard Arduino 
Uno offers. 

You see, while the Raspberry Pi has an exoellent array of 
pins and capabilities, it can’t do analogue and it can’t do real- 
time processing out of the box. With an Arduino, additions like 
servos, potentiometers and a whole array of analog sensors 
are trivially easy to trigger and control. 

The best part is that you don’t even have to program in 
Arduino’s quasi-C-h-l- language. All you need is a standard 
USB connection between your Raspberry Pi and Arduino and 
a small Python package called Nanpy. Here’s how it’s done... 


Grab an Arduino 

I Before you can do anything, you 
need an Arduino. We recommend the 
Uno, since it’s the default choice with the 
best balance of features, convenience 
and affordability. Since you’ll want to put 
it to use straight away, we recommend 
investing in a ‘starter kit’ that includes 
LEDs, servos and allthatfun stuff. 


Satisfying dependencies 

We’re assuming you’re using 
Raspbian (recommended), so open 
your terminal because we need to get 



PROGRAM YOUR ARDUINO WITH RASPBERRY PI 


The best part is that you 
don’t even have to program in 
Arduino’s quasi-C++ language 


setuptools so we can install Nanpy. At the terminal, type: 

I wget https://bitbucket.org/pypa/setuptools/raw/ 
bootstrap/ez_setup.py 
I python ez_setup.py user 

Once this is complete, you'll be able to use the easy_install 
command to i nstall pyserial. . . 


Full code listing 

# Like all good hardware-based ‘Hello, World’ applications, we’ll start 

# by making the light on the Arduino board flicker off and on. 

from nanpy import Arduino 
from time import sleep 


Final preparations 

Since the communication between the Arduino and 
Raspberry Pi will happen over the USB serial connection, we 
need to get the Python-serial li brary. At the terminal, type: 

I easy_install pyserial 

We also need to install the Arduino software so the Pi knows how 
to deal with the device when it’s plugged in. In the terminal, type: 

i sudo apt-get update 

sudo apt-get install arduino 


Arduino.pinMode(13, Arduino. OUTPUT) 
for i in range(10): 

Arduino. digitalWrite(13, Arduino. HIGH) 
sleep(2) 

Arduino. digitalWrite(13, Arduino. LOW) 
sleep(2) 

# This will make the light controlled by pin 13 on the Arduino 

# turn on and off every two seconds ten times. 

# You can also assign pins a name, to make your code more readable. 


Install Nanpy 

There are only two steps remaining in the configuration. 
First, we need to get the Nanpy package downloaded and 
installed on the Pi. Our preferred way is to clone it with Git. 
Navigate to your home folder in the terminal (cd -) and do the 
following in the terminal, one after the other: 

| easy_install nanpy 
sudo apt-get install git 
git clone https://github.cotti/nanpy/nanpy.git 

Configure your Arduino Uno 

Why have we cloned the original Git repository? 
Nanpy relies on an update to the Arduino firmware to function 
correctly, so you’ll need to access the firmware folder from the 
nanpy project directory to do it. Before typing the following into 
the terminal, plug your Arduino Uno into a spare port on the 
Raspberry Pi. Beware: the following takes some time! 
cd nanpy/firmware 
export BOARD=uno 
make 

make upload 




TestingArduino with your Pi 

With the installation finally complete, we can test the 
setup to make sure it works properly. Before we do a proper 
‘Hello World’ application in the code segment to the right, let’s 
first ensure Nanpy is properly installed and the connection 
between Pi and Arduino is working. From your home folder (cd 
~), type the following into the terminal: 

I nano nanpy_test.py 
In the nano editor, simply write: 

I from nanpy imort Arduino 

Now press Ctrl+X, Y, then Enter to save your new file. 

Finally, in the terminal, type: 

I Python nanpy_test.py 

If you don't see an error, then everything should be working fine. 
Now you can play with the code across the page to start learning 
yourway around Nanpy. 


light = 13 

Arduino. pinMode(light, Arduino. OUTPUT) 

# You can also assign multiple pins at the same time: 

red_pin = 3 
green_pin = 5 
blue_pin = 9 

for pins in (red_pin, green_pin, blue_pin): 

Arduino. pinMode(pins, Arduino. OUTPUT) 

# if you’ve got an LED screen for your RasPi you’ll probably 

# find it works out of the box with Nanpy. Just make sure you 

# assign the right pin numbers for your screen: 

from nanpy import (Arduino, Led) 

screen = Lcd([7, 8, 9, 10, 11, 12], [16, 2]) 
screen. printString(“Hello, World!”) 

# If you’re using potentiometers, buttons or analog sensors, 

# you’ll need to assign them as inputs 
knob = 0 

Arduino. pinMode(knob, Arduino. INPUT) 
value = Arduino. analogRead(knob) 
for i in range(10): 

print “The value of the knob is:”, knob 
sleep(l) 

# Sometimes you want to delay what the and 

# This can help you get consistent, solid r 

def get_value(): 

value = Arduino. analogRead(knob) 

Arduino. delay (100) 
return value 

for i in range(100): 

print “The value is:”, get_value() 


You’ll 

learn 


luino does, 
"eadings 


1. Playing to 
strengths 

While the RasPi is 
much more powerful 
than Arduino, the 
latter has the upper 
handwhenit comes 
to interfacing with 
the real world. 
Leverage both their 
strengths to make 
better projects. 
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Create a Raspberry Pi 
1hree-a>lour lamp 

Use the power of Arduino to do otherwise impossible 
projects with just a Raspberry Pi alone 


What yoi/l need 

■ Arduino Uno 

■ Breadboard 

■ Set of prototyping cables 

■ RGB LED (cathode) 

■ 3x potentiometers 

■ 3x 330 Ohm resisters 


In the previous project we showed you how you can 
use an Arduino microcontroller to help the Raspberry 
Pi become proficient in new skills that can drastically 
increase the reach of your projects. With the aid of the 

extra 12 pins capable of PWM and analogue input, you 
could easily add multiple servos, analogue sensors and 
even add input devices like joysticks. 

In this project we’re going to demonstrate this by creating 
a three-colour lamp that employs three potentiometers 
(twisty knobs) to control each of the three colours in an RGB 
LED light. With it you can make most of the colours of the 
rainbow. As you’d expect, this would be much more difficult 
usingjust a Raspberry Pi alone. 


Program with Arduino 

You’ll need to have followed the 
steps from with the previous project to 
correctly configure your Raspberry Pi and 
Arduino Uno. You’ll also need to ensure 
you’ve got all the components from the 
list to the left. The resistors should be 
330-ohm ideally, but can be of a higher 
resistance if that’s all you have available. 
Arduinos can be bought as part of 
‘starter packs’ that include exactly these 
kinds of components, but a quick visit to 
www.cpc.co.uk should fill any holes. 



■ This is a great prototype for an attractive 
RGB lamp - a great night light or mood piece 



CREATE A RASPBERRY PI THREE-COLOUR LAMP 



Populate the breadboard 

The circuit for this project might looks little complioated 
at first glanoe, but actually there’s very little going on. As you’d 
expect, we want to control the LED light using PWM-enabled 
pins (to have fine-grained control of the brightness) and the 
potentiometers (pots) are being read by the analogue pins. 

Connect the Arduino and Raspberry Pi 

Assuming you don’t plan to write up the oode 
immediately yourself, you can grab it from the diso or from the 
website and drop it in your home folder. With the USB cable from 
the Arduino plugged into the Raspberry Pi, you simply need to 
ru n the oode with the followi ng: 

I python RGB_Mixer.py 

Adjust the pots for the corresponding colour of the LED and 

Full code listing 

#!/usr/bin/env python 

from nanpy import Arduino 
from time import sleep 


# set LED pin numbers - these go to the 

# Digital pins of your Arduino 
redPin = 3 

greenPin = 6 
bluePin = 9 


# set pot pin numbers - these go to the 

# (A)nalog pins of your Arduino 
pot_r_Pin = 0 

pot_g_Pin = 3 
pot_b_Pin = 5 

#set three coloured pins as outputs 
for pins in (redPin, greenPin, bluePin): 

Arduino. pinMode(pins, Arduino. OUTPUT) 


the colours should change. If the pots are adjusting the wrong 
colours, just swap them over. You could use a table-tennis bailor 
plastic mug to diffuse the light to great effect. 


M Setting up the pins 

As we demonstrated in the last project, it’s easy to name 
and set the Arduino pins with Nanpy - in our oode we’ve used 
two simple for loops to do the job. The debug value below simple 
prints the values of eaoh pot to the terminal - very useful for 
debugging or getting a better handle on the code. 


Functional operation 

There are only really three main functions here, written 
with self-explanatory names. Firstly, get_pots() reads in the 
analogue pin value associated with each pot-pin and returns 
a tuple of the value for red, green and blue respectively. This is 
used by the colour_mixing() function to assign values to each of 
the associated PWM pins to change the colours ofthe LED. 


Keeping things running 

The mainO function is where the other funotions are set 
to work. Inside the function, we’re asking Python to mix the colours 
(and print the values if debug is True) forever, except if we press 
Ctrl-tC - initiating the keyboard interrupt. Since we want to clean 
up after ourselves, this action with trigger close_pins() - this turns 
off the pins attached to the LED, ready to be used next time. 


Youli 

learn... 



1. Analogue 
inputs 

It is possible to 
utilise analogue 
inputs with the 
Raspberry Pi using 
an analogue-to- 
digital converter 
(ADC) chip like 
theMPC3008, 
buttheyVe much 
easierto handle 
with an Arduino 
using Nanpy. 

2. Comment 
your code! 

We’ve tried to adhere 
to the best practices 
for commenting 
Python code in this 
project. We’re using 
‘#’ comments before 
assignments and 
quoted comments 
within functions. 


def colour_mixing(): 

Call get_pots() and set 
the colour pins accordingly 

r, g, b = get_pots() 

Arduino. analogWrite(redPin, r) 

Arduino. analogWrite(greenPin, g) 

Arduino. analogWrite(bluePin, b) 

Arduino. delay(l) 

def close_pins(): 

Close pins to quit cleanly (doesn't work with a 'for 
loop' despite the pins happily initialising that way!) 



Arduino. digitalWrite(redPin, Arduino. LOW) 
Arduino. digitalWrite(greenPin, Arduino. LOW) 
Arduino.digitalWrite(bluePin, Arduino. LOW) 


# set pot pins as inputs 

for pins in (pot_r_Pin, pot_g_Pin, pot_b_Pin): 

Arduino. pinMode(pins, Arduino. INPUT) 

# prints values to the terminal when True 
debug = False 

def get_pots(): 

Grab a reading from each of the pot pins and 
send it to a tuple to be read by the colour mixer 

r = Arduino. analogRead(pot_r_Pin) / 4 
Arduino. delay(l) 

g = Arduino. analogRead(pot_g_Pin) / 4 
Arduino. delay(l) 

b = Arduino. analogRead(pot_b_Pin) / 4 
Arduino. delay(l) 
return r, g, b 


def main(): 

Mix the colours using three pots. 

Ctrl+C cleans up the pins and exits. 

try: 

print "Adjust the pots to change the colours" 
while True: 

colour_mixing() 
sleep(0.2) 
if debug: 

print "Red: {:d} | Green: <-i 

{:d} I Blue: {:d}".format(r, g, b) 
except Keyboardinterrupt: 
close_pins() 
print "\nPins closed" 

if name == ' main ': 

main() 
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Make a igame 
wHhPytnon 

We update the retro classic Pong for the Linux generation 
with a new library called SimpleGUfTk 


What youll need 

■ Latest version of Raspbian 

www.raspberrypi.org/downloads 

■ Pillow 

https://github.com/python-i magi ng/ 
Pillow 

■ SimpleGUITk 

https://github.com/dholm/ 

simpleguitk/ 


The Raspberry Pi is a fantastic way 
to start learning how to code. One 

area that can be very rewarding for 
amateur coders is game programming, 
allowing for a more interactive 
result and a greater sense of 
accomplishment. Game programming 
can also teach improvisation and 
advanced mathematics skills for 
code. We’ll be using the fantastic 
SimpleGUITk module in Python, a 
very straightforward way of creating 
graphical interfaces based on Tkinter. 


Python module preparation 

\0 I Head to the websites we’ve listed in 'What you’ll need’ and 
download a zip of the sourcefilesfrom theGitHub pages. Update 
your Raspbian packages and then install the following: 

I $ sudo apt-get install python-dev python-setuptools 
tk8.5-dev tcl8.5-dev 


Install the modules 

Open the terminal and use cd to move to the extracted 
Pillow folder. Once there, type: 

I $ sudo python setup, py install 

Once that’s complete, move to the simpleguitk folder and use the 

same command to i nstall that as well. 


■ Rob got off to a good start, but it was 
all downhill from there. . . 
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MAKE A GAME WITH PYTHON 


Write your code 

Launch IDLE 2, rather than IDLE 3, and open a new 
window. Use the code listing to create our game Tux for Two’. Be 
careful to follow along with the code to make sure you know what 
you’re doing. This way, you oan make your own changes to the 
game rules if you wish. 

Set up the game 

There’s nothing too groundbreaking to start the code: 
Tux’s and the paddles' initial positions are set, along with the 
initial speed and direction of Tux. These are also used when 
a point is won and the playing field is reset. The direction and 
speed is set to random for each spawn. 


The SimpleGUI code 

The important parts in the draw function are the 
draw_line, draw_image and draw_text functions. These are 
specifically from SimpleGUI, and allow you to easily put these 
objects on the screen with a position, size and colour. You need to 
tie them to an object, though - in this case, canvas. 

SimpleGUI setup code 

The last parts are purely for the interface. We tell the 
code what to do when a key is depressed and then released, and 
give it a frame to work in. The frame is then told what functions 
handle the graphics, key functions etc. Finally, we give it 
frame.startO so it starts. 






Full code listing 

import simpleguitk as simplegui 
import random 

w = 600 
h = 400 
tux_r = 20 
pad_w= 8 
pad_h = 80 

def tux_spawn(right): 

global tux_pos, tux_vel 
tux_pos = [0,0] 
tux_vel = [0,0] 
tux_pos[0] = w/2 
tux_pos[l] = h/2 
if right: 

tux_vel[0] = random. randrange(2, 4) 
else: 

tux_vel[0] = -random. randrange(2, 4) 
tux_vel[l] = -random. randrange(l, 3) 

def start(): 

global paddlel_pos, paddle2_pos, paddlel_vel, paddle2_vel 

global scorel, score2 

tux_spawn (random. choice([True, False])) 

scorel, score2 = 0,0 

paddlel_vel, paddle2_vel = 0,0 

paddlel_pos, paddle2_pos = h/2, h/2 

def draw(canvas): 

global scorel, score2, paddlel_pos, paddle2_pos, <-i 
tux_pos, tux_vel 

if paddlel_pos > (h - (pad_h/2)): 

paddlel_pos = (h - (pad_h/2)) 
elif paddlel_pos < (pad_h/2): 

paddlel_pos = (pad_h/2) 
else: 

paddlel_pos += paddlel_vel 
if paddle2_pos > (h - (pad_h/2)): 

paddle2_pos = (h - (pad_h/2)) 
elif paddle2_pos < (pad_h/2): 

paddle2_pos = (pad_h/2) 
else: 

paddle2_pos += paddle2_vel 
canvas. draw_line([w / 2, 0],[w / 2, h], 4, “Green”) 
canvas. draw_line([(pad_w/2), paddlel_pos + (pad_h/2)], 
[(pad_w/2), paddlel_pos - (pad_h/2)], pad_w, “Green”) 

canvas. draw_line([w - (pad_w/2), paddle2_pos + (pad_h/2)], 

[w - (pad_w/2), paddle2_pos - (pad_h/2)], pad_w, “Green”) 
tux_pos[0] += tux_vel[0] 
tux_pos[l] += tux_vel[l] 

if tux_pos[l] <= tux_r or tux_pos[l] >= h - tux_r: 

tux_vel[l] = -tux_vel[l]*l.l 
if tux_pos[0] <= pad_w + tux_r: 


if (paddlel_pos+(pad_h/2)) >= tux_pos[l] <-u>= (paddlel_ 
pos-(pad_h/2)): 

tux_vel[0] = -tux_vel[0]*l.l 
tux_vel[l] *- 1.1 
else: 

score2 += 1 
tux_spawn(True) 

elif tux_pos[0] >= w - pad_w - tux_r: 

if (paddle2_pos+(pad_h/2)) >= tux_pos[l] >= »-u 
(paddle2_pos-(pad_h/2)): 

tux_vel[0] = -tux_vel[0] 
tux_vel[l] *- 1.1 
else: 

scorel += 1 
tux_spawn(False) 

canvas. draw_image(tux, (265 / 2, 314 / 2), (265, 314), 
tux_pos, (45, 45)) 

canvas. draw_text(str(scorel), [150, 100], 30, “Green”) 
canvas. draw_text(str(score2), [450, 100], 30, “Green”) 

def keydown(key): 

global paddlel_vel, paddle2_vel 
acc = 3 

if key == simplegui. KEY_MAP[“w”]: 

paddlel_vel -= acc 
elif key == simplegui. KEY_MAP[“s”]: 

paddlel_vel += acc 
elif key==simplegui . KEY_MAP[“down”] : 

paddle2_vel += acc 
elif key==simplegui .KEY_MAP[“up”] : 
paddle2_vel -= acc 

def keyup(key): 

global paddlel_vel, paddle2_vel 
acc = 0 

if key == simplegui. KEY_MAP[“w”]: 

paddlel_vel = acc 
elif key == simplegui. KEY_MAP[“s”]: 
paddlel_vel = acc 

elif key==simplegui.KEY_MAP[“down”]: 

paddle2_vel = acc 
elif key==simplegui.KEY_MAP[“up”]: 
paddle2_vel = acc 

frame = simplegui. create_frame(“Tux for Two”, w, h) 
frame. set_draw_handler(draw) 
frame. set_keydown_handler(keydown) 
frame. set_keyup_handler(keyup) 

tux = simplegui. load_image(‘http://upload. wikimedia.org/ 
wikipedia/commons/a/af/Tux.png’) 

startO 

frame.startO 



10 PRACTICAL RASPBERRY PI PROJECTS 


■j 


Raspberry Pi stop 
motion animation 


Fancy yourself as the next Nick Park? Set up this DIY stop- 
motion studio and see what you can do 


What youll need 

■ Latest version of Raspbian 

www.raspberrypi.org/downloads 

■ picamera Python module 

picamera.readthedocs.org 

■ RasPi camera module 

■ Pygame 

www.pygame.org 


■ Pi-Mation is available on GitHub via 
https://github.com/russb78/pi-mation 


The Raspberry Pi camera module 
opens the door for your Pi projects to 
incorporate aspects of photography 
and movie making. We’re combining 
both here to create a fully featured stop- 
motion animation application, Pi-Mation, 
which makes it incredibly easy to create 
impressive HD animations. 

We’ve written this project with 
Python and it relies on two libraries 
that you will need to install. Picamera 
{picamera.readthedocs.org) is a pure 
Python interface to the Raspberry 
Pi camera module and is a must for 
all camera module owners. Pygame 
(www.pygame.org), which ensures our 
images can be displayed on demand. 


Set up the camera module 

I Firstthingsfirst,you needtomakesureyourRaspberry 
Pi is uptodate. In the terminal, type: 

I sudo apt-get update && sudo apt-get upgrade 
Next we need to u pdate the Pi’s fi rmare and ensu re camera 
module is activated. Bear in mind that this takes sometime. 

i sudo rpi-update 
sudo raspi-config 


Install other dependencies 

Next we’ll make sure Pygame and picamera are installed 

I sudo apt-get install python-setuptools 
easy_install -user picamera 
Finally, to install Pygame and the video apps, type: 

I sudo apt-get install python-pygame 
sudo apt-get install libav-tools && sudo 
apt-get install omxplayer 


RASPBERRY PI STOP MOTION ANIMATION 


Final setup 

We’re going to install Pi-Mation 
with Git, so let's make sure it's installed: 

I sudo apt-get install git 
With aterminal open, navigate to your 
home directory (with cd-)andtype: 

I git clone https://github.com/ 
russb78/pi-mation . git 
If you play with the code and break it, you 
can revert it back to its original state with: 
I git checkout pi-mation.py 


Running and testing 
Pi-Mation 

Now navigate into the pi-mation folder 
and run the application with: 

I python pi-mation.py 
Pressi ng the space bar calls take_pic() 
from the main() loop, which saves an 
image and creates a preview that’s loaded 
by update_display(). The Tab button is 
coded to toggle between two states by 
askingtwo variables to switch values. 


Getting animated 

The mainO loop checks for keyboard events before 
updating the screen around 30 times per second. Since the 
camera's live preview is working independently of that loop, 
update_display() only needs to worry about updating the 
preview image (prev_pic) Since take_pic() adds to picsjaken, 
only the very latest picture is shown. The animateO function is 
essentially a microcosm of update_display(). When the P key is 
pressed, the live preview is suspended and for all of the pictures 
taken (picsjaken), each one will be ‘blitted’ (updated) on the 
main window. 


Full code listing 

import pygame, picamera, os, sys 
picsjaken = 0 

current_alpha, next_alpha = 128, 255 
fps = 5 

pygame. init() 

res = pygame. display.list_modes() # return the best resolution 
for your monitor 
width, height = res[0] 

print "Reported resolution is:", width, "x", height 
start_pic = pygame. image. load(os.path.join('data', 
'start_screen.jpg')) 

start_picjix = pygame.transform.scale(start_pic, (width, height)) 

screen = pygame. display.set_mode([width, height]) 

pygame. display, toggle JullscreenO 

pygame. mouse. set_visible = False 

play_clock = pygame. time. Clock() 

camera = picamera. PiCamera() 

camera. resolution = (width, height) 

def take_pic(): 

global picsjaken, prev_pic 
picsjaken += 1 

camera. capture(os.path.join('pics', 'image_' + 
str(picsjaken) + '.jpg'), use_video_port = True) 

prev_pic = pygame. image. load(os.path.join('pics', 'image_' + 
str(picsjaken) + '.jpg')) 

def delete_pic(): 

global picsjaken, prev_pic 
if picsjaken >= 1: 
picsjaken -= 1 

prev_pic = pygame. image. load(os.path.join('pics', ^ 
'image_' + str(pics Jaken) + '.jpg')) 

def animate(): 

camera. stop_preview() 

for pic in range(l, picsjaken): 

anim = pygame. image. load(os.path.join('pics', 'image_' + 
str(pic) + '.jpg')) 

screen. blit(anim, (0, 0)) 
play_clock.tick(fps) 
pygame. display. flipO 
play_clock.tick(fps) 
camera . sta rt_preview() 

def update_display(): 
screen. fill((0, 0,0)) 
if picsjaken > 0: 

screen. blit(prev_pic, (0, 0)) 
play_clock.tick(30) 
pygame. display.flipO 

def make_movie(): 

camera. stop_preview() 
pygame. quit() 


print "\nQuitting Pi-Mation to transcode your video." 
os.systemC'avconv -r " + str(fps) + ” -i " + str((os.*-' path. 
joinCpics', 'image_%d.jpg'))) + " -vcodec libx264 video. mp4") 
sys.exit(0) 

def change_alpha(): 

global current_alpha, next_alpha 
camera . stop_preview() 

current_alpha, next_alpha = next_alpha, current_alpha 
return next_alpha 

def quit_app(): 
camera. closeO 
pygame. quitO 

print "You've taken", picsjaken, " pictures. Don't 
forget to back them up!" 
sys.exit(0) 

def intro_screen(): 
intro = True 
while intro: 

for event in pygame. event. get(): 

if event. type == pygame. KEYDOWN: 
if event. key == pygame. K_ESCAPE 
quit_app() 

elif event. key == pygame. K_F1: 
camera. start_preview() 
intro = False 

screen. blit(start_picjix, (0, 0)) 
pygame. display. updateO 

def main(): 

intro_screen() 
while True: 

for event in pygame. event. get(): 

if event. type == pygame. KEYDOWN: 
if event. key == pygame. K_ESCAPE 
quit_app() 

elif event. key == pygame. K_SPACI 
take_pic() 

elif event. key == pygame. K_BACKSPACE: 
delete_pic() 

elif event. key == pygame. K_RETURN: 
make_movie() 

elif event. key == pygame. K_TAB: 

camera. preview_alpha = change_alpha() 
camera. start_preview() 
elif event. key = pygame. K_F1: 
camera . stop_preview() 
intro_screen() 

elif event. key == pygame. K_p: 
if picsjaken > 1: 
animateO 

update_display() 

if name == ' main ': 

main() 






Hardware 

32 Make a Pi 2 desktop PC 

Use your Pi as a replacement PC 

36 How I made: PiKon 

Check out this 3D-printed telescope 

38 Build a RasPi-controlled car 

Take control of a remote-controlled car 

44 How I made: Robot arm 

Get to grips with a Pi-powered robot arm 

46 Make a Raspberry Pi hiTPC 

Finally create a more powerful machine 

48 Make a tweeting wireless 
flood sensor 

Flood-proof your basement 


30 



Construct a 
RasPi HTPC 


Read up on this 
3D-printed telescope 


Power up a 
portable tank 


50 Build a Raspberry 
Pi-powered Bigtrak 

Control your own all-terrain vehicle 

54 How I made: PiPanther 

Battle your friends in augmented reality 

56 Make a digital 
photo frame 

turn your Pi into a beautiful photo frame 

60 How I made: Pi Glass 

Watch these coders hack video goggles 

62 Build a Raspberry Pi 
Minecroft console 

Create a fully functional games console 


DIY augmented 
reality glasses 


Display your 
digital photos 


What happens when you link 48 Pis together? 






HARDWARE 


Make a Pi 2 desktop PC 


Use your Raspberry Pi as a desktop replacement PC thanks to the 
inaeased power of the Raspberry Pi 2 



The Raspberry Pi 2’s increased power over its predecessor 
is well-documented by now. More CPU cores and more RAM 
making it six times faster is an impressive number, and you 
can see the actual changes that it makes to the experience. 

This power aotually enables you to conduot a very simple 
projectthat wasjust out of reach for the original Raspberry Pi: 
a Raspberry Pi desktop PC. 

All the components for it were available, but the Pi wasjust 
a little too slow to properly give a fluid desktop experience. 
Now with the improved resources, many of the restrictions 
are gone - enough of them to be able to build a Pi desktop. So 
grab a Pi 2 and we’ll get started. 


What youll need 

■ Raspberry Pi 2 

■ Raspbian 

raspberrypi.org/downloads 

■ Keyboard 

■ Mouse 

■ Wireless dongle 

■ Monitor 

■ Case 

■ Powered USB hub (optional) 


Get Raspbian 

I We will be using Raspbian for our desktop Pi. Not only is 
it simple to obtain and easy to use, but it is supported by the Pi 
Foundation and community, which means it’s going to be the 
most flexible operating system with the most choices for a 
desktop. Download it from: www.raspberrypi.org/downloads. 


— ET 



MAKE A PI 2 DESKTOP PC 



Install Raspbian 

Once Raspbian is downloaded, you oan install it to your 
SD card. Put the micro SD into an SD card reader and connect it 
to your main system (a PC or laptop). Open up the terminal, cd to 
the looationofthe image and use: 

I $ sudo dd bs=lM if=raspbian.img of=/dev/[location of 
SD card] 

Setup options 

On first boot there will be some setup stuff that it is 
necessary you go through. The most important things to do for 
this desktop are to first hit ‘Enable Boot to Desktop’ and then to 
extend the installation to fill the entire SD card. After you have 
done that, do anything else that you want to do in these menus 
and then reboot before movingon to the next step. 

M First boot 

You will boot into a fresh version of Raspbian with the 
newer interfaoe and default apps available to use. From here 
you can start using it as normal if you wish, but it is worth noting 
that there are a few extra things that you should do to make it 
truly desktop worthy. 

Software updates 

Our first step is to perform an upgrade on the system to 
make sure it's all up to date and working properly. To do this, open 
up the terminal from the menus and use: 

I $ sudo apt-get update 


... to refresh the software list, followed by the next command to 
then upgradeto newer software: 

I $ sudo apt-get upgrade 



Above Make sure 
yousetthePito 
boot straight to the 
desktop, like your 
main computer 


Firmware upgrade 

While we're updating, it’s a good idea to upgrade the 
firmware on the devioe. Still in the terminal, you’ll want to 
aotivate the firmware upgrade software with: 

I $ sudo rpi-update 

Extra configuration 

\09 At this point, you might want to tweak the Pi a little 
further. To bring up the initial configuration screen, you’ll need to 
go back into the terminal and launoh it with: 

I $ sudo raspi-config 


Advanced options 

From here you can activate some extra options that you 
might need in the future. Enabling the Pi camera driver is a good 
first step, and you oan even have it boot to Scratch if you want to 
focus on fun game development. Otherwise, there are also some 
overolocking options that you oan consider if the system starts 
getting slow for you. 





HARDWARE 




Accessorise your Pi 

Just setting up the operating system on the Raspberry 
Pi is only a small part of the process - we also have to consider 
the hardware surrounding it that will actually make it usable as 
a desktop replaoement. 


W Anything else? 

Our standard desktop PC setup is complete, with 
one USB port to spare. You can use that single port for USB 
sticks or portable storage, or you can invest in a powered 
USB hub to give yourself more oonnectivity options. Otherwise, 
investing in a good, 2A power supply will make sure you’re never 
shorten powerfor anything. 


Below You can run 
a pretty decent 
Minecraft server 
fora handfulof your 
friends with the Pi 2 


Human input devices 

Standard USB keyboards and mice are best suited for 
this task, much more so than a lot of the wireless keyboard and 
mouse combos that are popular among Pi users. However, 
don’t try and save on USB ports by getting a keyboard with USB 
connections of its own: the Pi oannot power USB hubs, even just 
two on a keyboard. 


Monitor to see 

I I The Pi can output a maximum of 1080p, which in normal 
displayterms is 1920x 1080. While it onlyoutputs in HDMI, alotof 
modern monitors do have an HDMI input. If you don’t want to get 
a brand new monitorthough, you can always get a HDMI to D'V'I or 
H DM I to VGA adapter. 


Case for protection 

The Pi is pretty sturdy and we’d be lying if we said we didn’t 
regularly keep ours out of a case, however, it’s not indestructible. 
While we’re doing a lot of different projects involving accessing 
different components, a desktop Pi doesn’t require this level of 
access. We like the Pimoroni Pibow cases, but there are several 
other secu re, protective alternatives. 


Wireless for Internet 

While some people are fine using wired connections, not 
everyone has that luxury. Wireless dongles are a perfect fit for 
the Pi, especially now they’re almost no larger than the USB 
port themselves. However, not just any dongle will work and 
you'll have to check against this listto make sure that you geta 
compatible one: http://elinux.org/RPi_USB_Wi-Fi_Adapters. 





MAKE A PI 2 DESKTOP PC 




Adding extra software 

We’re not quite done getting our Raspberry Pi desktop 
ready just yet. We need to add some extra software to make it 
feel more like a real desktop. While we already have a browser 
installed and some of the basics, the first other piece of software 
we should add is an office suite. 


Work with LibreOff ice 

LibreOffice is not installed by default, but as the premier 
open source office suite, or Linux office suite in general, it is 
readily available on Raspbian, which is useful. Open up the 
terminal and install it with the following: 

I $ sudo apt-get install libreoffice 

GiMPfor photos 

I § This is the big one - while the original Pi was not quite able 
to handle LibreOffice, it was useless trying to use GIMP. Now 
GIMP works just fine, although more complex tasks might make 
it slow down just a touch. Install it with: 

I $ sudo apt-get install gimp 


Libreoffice is not installed by default, 
but as the premier open source office 
suite, or Linux office suite in general, it 
is readily available to use on Raspbian, 
which is useful 



Above With the Pi 
2, you can run a full 
office suite without 
runningintoany 
awkward slowdown 


IG XiX for music 

1^# If you need to listen to muslo while you work, one of the 
best pieces of software to oheck out is XiX. It’s available on the Pi 
Store. It's a free download and you can find the Pi Store in the Pi 
menusto install it. 


1ft Pi for desktop 

17 Now we are set up you oan start properly using your 
Raspberry Pi as a desktop system, while still making use of the 
eduoational capabilities when need be. The software repository 
and Pi Store should oontain any other software that you would 
want or need to make the most of your new Pi system. ■ 







SD-printed If you have already 
invested in a 3D printer or otherwise 
have access to one, the material cost 
of printingthe parts is negligible 


Camera module The camera | 

module’s lens has been removed and 
displaced below a4.5-inch mirror, 
which forms the image 


Optical tube 3D-printingthis 

part of the PiKon would have been 
very inefficient, so Andy and Mark 
used readily-availableventingduct 




The 3D-printed base for the telescope is 
also composed of pieces of Meccano as well 
as the small square of aluminium 


5ek Here is an example of the kind of photo 
that can be taken with the PiKon telescope; 
the Moon, with enough detail to be able to see 
its craters and surface texture 


Components Kst 

■ Raspberry Pi 

■ Camera module 

■ 3D printer 

■ 5 CAD files to print 

bit.ly/1wfl9a8 

■ White venting duct 

■ Small square of aluminium 

■ Focusing knob 

■ Meccano pieces 
■Tripod 
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HOW I MADE: PIKON 



How I made: 
PiKon 


ed telescope nie^ts PasPi camera 


Tell us how you began your project 

I run this small company 
called Alternative Photonics and 
like to find out about new technologies. 
When Sheffield’s Festival of the Mind 
came along I thought of what could we 
put together in terms of things that are 
new and disruptive, and that’s how the 
whole project started. The two things I 
was interested in were using Raspberry 
Pis for photography and 3D printing. 
With 3D printers you’ve got a device in 
the ballpark of £500, putting it amongst 
the price you’d pay for consumer items, 
so manufacturing is something you can 
do at home. There are companies who 
will print something for you, so you send 
in a design and they’ll produce it. And 
there are maker communities - Andy 
runs a group called Sheffield Hardware 
Hackers and Makers. 

Sheffield Hardware Hackers 
and Makers is for anyone off the street 
to come along to if they want to hack 
and make things. I set it up as part of 
the original RepRap project that ran on 
the Internet quite some years ago [Ed: 
RepRaps are 3D printer kits that can 
print parts for more RepRaps]. I found 
that there were quite a few people 
building printers who got to a certain 
point and then got stuck, so I set up 
this group originally to be a drop-in for 
people to come along to and get the help 
they needed. 

Andy, what was your role in the PiKon? 

I helped Mark pick a 3D printer 
that was going to be pitched right for his 
skillset and then, as he was building up 
the printer, when he got to bits where 
he got stuck he’d bring it along to the 
Hardware Hackers group and say ‘It 
doesn’t do this right’ or ‘I can’t get it 
to do that’, and we’d work through the 
problems together. Once he’d got his 
printer going, I worked through the CAD 
software with him to see what was 
available that was open source and within 
his capabilities. There are various things 
you can’t do with a 3D printer when you 
design parts, so we had a conversation 


about that and I gave him the shortcut to 
get working parts out quicker. 

How does the PiKon work? 

Most telescopes work on the 
principle that you have some sort of 
object lens or mirror which forms an 
image and then you use an eyepiece 
to examine that image, so it’s usually 
what’s termed as a virtual image. With 
the PiKon, what we’re doing is using 
the objective device, in this case a 
4.5-inch (335mm) mirror, to form an 
image and then placing the Raspberry 
Pi camera without its lens - so just a 
sensor - where the image is formed. So 
effectively, instead of using an eyepiece 
we’re examining the image electronically 
by placing the Raspberry Pi sensor 
there, and the sensor is suitably small so 
we’re able to examine a fairly small area 
of the image. 

What kind of resolution do you get? 

At the moment, the setup 
that we’ve got is equivalent to a 
magnification of about 160. If you 
look at the Moon, the field of view of 
your eye is about half of one degree; 
the PiKon’s maximum field of view 
is about a quarter of one degree, so 
effectively you can see about half the 
moon in full frame. The next thing I’d 
like to do is look at planets. In terms 
of its resolution, the PiKon’s sensor is 
five megapixels, which is 2500x2000 
pixels. If you’re going to reproduce 
an image in print you’d normally use 
something like 300dpi, so 5MP would 
allow you to reproduce something like 
an A4 image. On a computer screen 
all you need is 72dpi, so what I’m quite 
interested in doing next is seeing how 
much magnification we can get simply 
by cropping - so literally throwing away 
some of the pixels to be able to zoom in 
on something like a planet. If you read 


the Astronomy for Beginners stuff, they 
talk about needing a magnification of 
200-250 to be able to observe planets, 
so I’m hoping we can do things like see 
the rings of Saturn. We’re not out to rival 
the Hubble - we think that what you’ve 
got is a reasonable instrument and you 
can do a few interesting things with 
it. The other thing is that because it’s 
using a Raspberry Pi sensor instead of 
an eyepiece, you’re immediately into the 
world of astrophotography rather than 
doing observations, so that’s the sort of 
way we’re going. 

How do you control the PiKon’s camera? 

We would like to do it better! 

At the moment it’s done through 
the command line. I’m not a Raspberry 
Pi programmer... So we’re using 
raspistill at the moment, which gives 
you a certain number of seconds of 
preview and then takes the picture, 
so it’s a bit clunky. I’m talking to a guy 
who’s into Raspberry Pi and is also a 
photographer, and he’s written some 
programs where you have a shutter 
button. The next thing to do then is to 
control PiKon from an input/output 
device like a shutter button and 
then give the JPG files you produce a 
sequential or a date-stamped filename. 
One thing I’d like to see next is if we 
could get this hardware out into the 
public and attract people to actually 
come along and develop more and more 
software for it. I tried taking pictures of 
the International Space Station with an 
ordinary camera, for example. It’s really 
difficult because suddenly this dot 
comes flying across the horizon and you 
have to swing around, get your camera 
lined up, press the shutter and so on. 
One thought I had was it would be nice 
if you could take multiple shots with the 
PiKon - you press a button and it keeps 
taking a photograph every five seconds. 


The setup we’ve got is equivalent 
tea magnification of about 160 



isa member of 
the Institute of 
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Society 



And'/ Kirby 

was an early 
contributorto the 
RepRap project and 
runs the Sheffield 
Hardware Hackers 
and Makers group 

Like it? 

The Raspberry Pi 
Foundation website 
featured a project 
that mounts the 
Pi and camera 
onto a telescope 
and captures 
great images bit. 
ly/1qTp3Pb 

Further 

rea“ing 

If you’re interested 
in astrophotography 
and developing 
software for 
PiKon, checkout 
these astronomy 
packages: 
bit.ly/100wj65 



HARDWARE 


Build a Raspberry 
Pi-controllecI car 


Make use of cutting-edge web technologies to take control of a 
remote controlled car with a smartphone or tablet. . . 




BUILD A RASPBERRY PI-CONTROLLED CAR 



Web technologies are moving forward at a huge pace, cloud 
technologies are bringing mass computing to individuals, 
and hardware has reached a perfect moment in time where 
sensors, displays and wireless technology have all evolved 
into efficient and affordable devices. We truly are at a point 
where nearly anyone can take an idea from nothingto a working 
product in a week and at very little cost. Just like this project, 
which is fun, quick and easy to build on and a fantastic way to 
learn. We’re going to grab an old remote-control car, rip off its 
radio receiver and replace it with the Raspberry Pi, hook it up on 
the network, fire up a bleeding-edge web server and then get 
your smartphone or tablet to control it by tilting the device. By 
the end of this, not only will you have a fun toy - you will have 
learnt about the basic technologies that are starting to power 
the world’s newest and biggest economy for the foreseeable 
future. Welcome to tomorrow! 
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Raspberry Pi-controlled car build process 


Components list 

■ A toy RC car with two 
channels (steering and drive) 

■ Adafruit PWM I2C 
servo driver 

■ Female-to-female 
jumper cables 

■ 5V battery power bank 

Estimated cost: £60/$100 


Components from 

www.modmypi.com 


Before you con take control of your car with a smartphone, you'll 
need to make some significant changes to the chassis 


To help our toy car come to life using the 
latest web technologies and our credit 
card-sized computer, we’re going to 
need to make some pretty significant 
changes to its workings. Fortunately, 
the most complex aspects of the build 
can be accomplished with a couple 
of affordable purchases, namely a 
servo controller board to take care 
of the steering and throttle, and a 5V 
battery pack to keep the Raspberry Pi 
runningsmoothly. 


Identify and remove old radio 

I This project is effectively replacing the car's normal 
transmitter and receiver. Notice the three sockets on the original 
receiver: one goes to the motor controller and one to the steering 
servo. Some remote-control cars also have separate battery for 
the electronics, but those (especially with an electronic speed 
controller with BEG) get their 5V power supply directly from 
the speed controller, saving on components. If you don’t have 
a speed controller with 5V BEG, you’ll need to get a 5V supply 
elsewhere. Many shops sell 5V battery power supplies - often as 
mobile phone emergency top-ups. www.modmypi.com sells a 
suitable 5V battery power bankfor under £20. 



Power up ThisSV battery 

pack keeps our Raspberry Pi 
runningforagoodfew hours 


Pick a car You can use 

pretty much any affordable 
carforthis project 


Pi- powered The Raspberry 

Pi sits front and centre to keep it 
as safe as possible 


Servo control We’ve used 

the Adafruit PWM I2C servo driver 
board from www.modmypi.com 




BUILD A RASPBERRY PI-CONTROLLED CAR 


f We’re usingthe Raspberry Pi’s 
I2C bus to control the servo 
interface board 


Attach the servo cables to 
the new controller 

We soldered our 16-channel I2C servo 
controller board from www.modmypi.com 
as per its instructions and simply plugged 
channelO (steering) and channel 1 (motor) 
headers onto it. There are six cables in 
total: the bottom two are ground, the 
middle two are the power and the top two 
are the PWM (pulse-width modulation) 
signals. This is a good time to think of 
places to mount the extra components 
and the best fixing method seems to be 
sticky-back Velcro. 

Connect the I2C bus to the 
Raspberry Pi 

We’re using the Raspberry Pi's I2C bus 
to oontrol the servo interface board, 
which only needs four cables - they all go 
between the Raspberry Pi and the servo 
controller board as pictured. This month’s 
accelerometer tutorial explai ns how to set 
up I2C on the Raspberry Pi. 

From top to bottom we need to use the 
1. GND, 2. SCL, 3. SDA and 4. VCC, whioh 
map direotly to the same ports on the 
Raspberry Pi. Essentially this is power, 
ground and two oommunication channels 
- it’s all pretty straightforward so far. . . 

M Hooking it up to the 
Raspberry Pi 

On a Rev 1 Raspberry Pi, the cables look 
the same. Though the Rev boards have 
different labelling, the physical pins are 
in the same place. Bottom left (closest 
to the RasPi power connector) is the 3.3V 
power; next to that is the SDA header. 


which is the data channel. Next to that 
in the bottom right is the SCL channel, 
which controls the clock of the I2C 
devices. And finally - on the top-right port 
- istheGround. 

Overview of the main 
components 

You should now have the servo board in 
the middle with the steering servo and 
speed oontroller on one side and the 
Raspberry Pi on the other. The motor is 
oonnected to the other end of the speed 
oontroller (that end should have muoh 
thicker wires); the speed controller 
also has two thick wires going to the 
main car’s battery - in this case a 7.2V 
NiCad. We now have two very separate 
power systems with the high current 
motors on one side and the low current 
electronics on the other. Let’s make 
sure it stays that way! 

Find everything a home 

Now it’s time to find a home 
for the new components. Use plenty of 
sticky-back Velcro, tie wraps or elastio 
bands to keep everything secure and 
find spaces in the car’s body to hide the 
wires where possible. While it is possible 
to stick or screw the Raspberry Pi directly 
to the car, we recommend to use at least 
the bottom half of a case for added 
protection and ease of acoess. Insert your 
SD card, network cable or Wi-Fi dongle (if 
programming from another machine) and 
power supply. Sit back and admire your 
hacking. Next we’ll tackle the software 
side of the project... 














^^^^JHARDWARE 


G)ntrolling your Raspberry Pi-powered car 

Control 0 toy cor with a smartphone and the latest web technologies 


Now we have our fantastic Raspberry 
Pi-powered car ail wired and charged, 
it’s time to make it come alive. We’re 
using the best web technologies 
that the JavaScript programming 
language offers, to harness the natural 
movement of your hand and wirelessly 
drive the vehicle. Each little movement 
will trigger an event that calculates 
what the car should do and then sends 
it over a socket connection up to 20 
times a second. 

Download and install 
the software 

To get the I2C connectivity working, 
you can follow the steps from pages 
64-65. Next we’ll need to find a home 
for our new project code - how about / 
var/www/picar? Type sudo mkdir / 
var/www/picar in the terminal to make 
the directory and then change into that 
directory: cd /var/www/picar 

Now, to download the project using 
Git, type sudo git clone http:// 
github.com/shaunuk/picar. If you 
haven’t got Git, install it with sudo apt- 
get install git. 

This will download the custom 
software for driving the car, but we still 
need the web server and some other bits 
before we can start bu rning rubber. . . 

Download and install 
Node.js 

We now need to get the awesome Node, 
js and its package tool, the Node package 
manager (npm). Type sudo wget http:// 
nodejs.org/dist/v0.10.21/node- 
v0.10.21-linux-arm-pi.tar.gz. This 
will download a fairly recent version of 
Node.js - the version Raspbian has in 
its repositories is way too old and just 


Step 07 


What youll need 

■ A RasPi car, ready to go 

■ An internet connection 

■ A reasonably modern 
smartphone/tablet 

■ Pi car source code 

github.com/shaunuk/picar 


doesn’t work with the new technologies 
we’re about to use. Extract the node 
package by typing sudo tar -xvzf 
node-v0 . 10. 21-lin ux-a rm-pi.tar.gz. 

Configure Node.js 

To make it easy to run from 
everywhere, we will create symbolic 
links for Node and npm binaries. In the 
terminal, type sudo In -s /var/www/ 
node-v0.10.21-linux-arm-pi/bin/ 
node /bin/node and then sudo In 
-s /var/www/node-v0.10.21-linux- 
arm-pi/bin/npm /bin/npm. Then, 
to get the extra modules, type npm 
install socket. io node-static 
socket, io adafruit-i2c-pwm-driver 
sleep optimist 

Get to know the project 

Now we have everything, you 
should see three files: the server (app.js), 
the client (socket.html) and the jQuery 
JavaScript library for the client. The 
server not only drives the servos, but it 
is a web server and sends the socket, 
htmlfile and jQuery to the browser when 
requested - it’s a really neat and simple 
setup and just right for what we’re trying 
to achieve. 

Below Allyou need to finish offyour project is 
access to a smartphone or tablet 








Above You need to adjust some of the variables to control your 
particular remote controlled car set-up 


Test the servos 

Our handy little program (app.js) has a speoial mode 
just for testing. We use two keywords here: beta for servo 0 
(steering) and gamma for servo 1 (motor control). Type node 
app.js beta=300. You should see the front wheels turn. Now the 
numbers need experimenting with. On our example, 340 was left, 
400 was centre and 470 was right. Do the same for the motor by 
typing node app.js gamma=400 and take note of the various 
limits ofyourcar. 

Configure sensible defaults 

Now you know what your car is capable of, we 
can set the defaults in app.js and socket.html. Edit app.js 
and find the section that says ‘function emergencyStop’. 
Adjust the two numbers to your oar’s rest values. Then open 
socket.html and adjust the predefined values under ‘Define 
your variables here’. 


Going for a spin 

§ We’re almost ready totryitout,butyou need to know the 
IP address of your Pi car, so type ifconfig at the terminal. Then 
fire up the app by typing node app.js. Now grab the nearest 
smartphone or tablet, making sure it’s on the same network 
as your Pi. Open the web browser and go to http://[your IP 
address]:8080/socket.html. You should get an alert message 
saying ‘ready’ and as soon as you hit OK, the gyro data from your 
phone will be sent to the car and you’re off! 





BUILD A RASPBERRY PI-CONTROLLED CAR 


IWe’ll harness the natural movement of your 
I hand and wirelessly drive the vehicle 


Full code listing 

socket.html 

<html> 

<head> 

<script src=”jquery-2.0.3.min.js” language=”javascript”></ 
script> 

<script src=”/socket.io/socket.io.js”></script> 

<meta name=”viewport” content=”user-scalable=no, initial- 
scale=1.0, maximum-scale=1.0;” /> 

<script> 

// Define your variables here 

var socket = io.connect(window. location. hostname+’:8080’); 
var centerbeta = 400; //where is the middle? 
var minbeta = ‘340’; //right limit 
var maxbeta = ‘470’; //left limit 

var multbeta = 3; //factor to multiply the raw gyro figure 
by to get the desired range of steering 
var centergamma = 330; 

var ajustmentgamma = 70; //what do we do to the angle to get 
to 0? 

var mingamma = 250; //backwards limit 
var maxgamma = 400; //forward limit 

var multgamma = *; //factor to multiply the raw gyro figure 
by to get the desired rate of acceleration 
window. Iastbeta=’0’; 
window. Iastgamma=’0’; 

$(function(){ 
window. gyro = ‘ready’; 
alert(‘Ready — Lets race !’); 

»; 

window. ondeviceorientation = function(event) { 

beta = centerbeta+(Math.round(event.beta*-l)*multbeta); 
if (beta >= maxbeta) { 
beta=maxbeta; 

} 

if (beta <= minbeta) { 
beta=minbeta; 

} 

gamma = event. gamma; 

gamma = ((Math.round(event.gamma)+ajustmentgamma)* 
multgamma)+ centergamma; 

//stop sending the same command more than once 
send = ‘N’; 

if (window. lastbeta != beta) { send = ‘Y’ } 
if (window. lastgamma != gamma) { send = ‘Y’ } 
window. lastbeta=beta; 
window. lastgamma=gamma; 

if (window. gyro == ‘ready’ && send==’Y’) { //don’t send 
another command until ready... 
window. gyro = ‘notready’; 

socket. emit(‘fromclient’, { beta: beta, gamma: gamma } ); 
window. gyro = ‘ready’; }} 

app.js 

//declare required modules 

var app = require(‘http’).createServer(handler) 

, io = require(‘socket.io’).listen(app) 

, fs = require(‘fs’) 

, static = requireCnode-static’) 

, sys = require(‘sys’) 

, PwmDriver = require(‘adafruit-i2c-pwm-driver’) 

, sleep = require(‘sleep’) 

, argv = require(‘optimist’).argv; 
app.listen(8080); 


//set the address and device name of the 
breakout board 

pwm = new PwmDriver(0x40,’/dev/i2c-0’); 

//set pulse widths 

setServoPulse = function(channel, pulse) { 
var pulseLength; 
pulseLength = 1000000; 
pulseLength /= 60; 

print(“%d us per period” % pulseLength); 

pulseLength /= 4096; 

print(‘‘%d us per bit” % pulseLength); 

pulse *= 1000; 

pulse /= pulseLength; 

return pwm.setPWM(channel, 0, pulse); 

}; 

//set pulse frequency 
pwm.setPWMFreq(60); 

//Make a web server on port 8080 
var file = new(static.Server)(); 
function handler(request, response) { 
console. log(‘ serving f ile’, request. url) 
file.serve(request, response); 

}; 

console. log(‘Pi Car we server listening on port 8080 visit 

http://ipaddress:8080/socket.html’); 

lastAction = 

function emergencyStop(){ 

pwm.setPWM(0, 0, 400); //center front wheels 
pwm.setPWM(i, 0, 330); //stop motor 

console. log(‘###EMERGENCY STOP - signal lost or shutting 
down’); 

} 

if (argv. beta) { 

console. log(‘‘\nPerforming one off servo position move 
to: “+argv.beta); 

pwm.setPWM(0, 0, argv. beta); //using direct i2c pwm module 
pwm.stopO; 

return process. exit(); 

} 

if (argv. gamma) { 

console. log(‘‘\nPerforming one off servo position move 
to: “+argv. gamma); 

pwm.setPWM(i, 0, argv. gamma); //using direct i2c pwm module 
pwm.stopO; 

return process. exit(); 

} 

//fire up a web socket server 
io. sockets. on(‘connection’, function (socket) { 
socket. on(‘fromclient’, function (data) { 
console. log(‘‘Beta: '‘+data.beta+” Gamma: ‘‘+data. gamma); 
//exec(‘‘echo ‘sa ‘‘+data+’” > /dev/ttyAMA0”, puts); //using 
http://electronics.chroma.se/rpisb.php 

//exec(‘‘picar.py 0 ‘‘+data.beta, puts); //using python 
adafruit module 

pwm.setPWM(0, 0, data. beta); //using direct i2c pwm module 
pwm.setPWM(i, 0, data. gamma); //using direct i2c pwm module 
clearlntervai(lastAction); //stop emergency stop timer 
lastAction = setInterval(emergencyStop,1000); //set 
emergency stop timer for 1 second 
}): 

}); 

process. on(‘SIGINT’, function() { 
emergencyStopO; 

console. log(‘‘\nGracefully shutting down from SIGINT 
(Ctrl-C)”); 
pwm.stopO; 

return process. exit(); 

}); 



Robot Arm Available from MapLin 
Electronics and OWI Robotics, the arm 
comes with software for control even 
before you get the MPU-6050 involved 


Veroboard Veroboard is great 

to tidy up wires in projects like this, 
where they get in the way but can’t 
really be run through a breadboard 


HARDWARE 


MPU-6050 Containinga MEMS 

accelerometer and a MEMS gyroscope, 
this sensor reads the x,y and z axis 
channels with 16-bit ADC conversion 



Components list 


■ Raspberry Pi Model B 

■ Maplin Robotic Arm Kit With 
USB PC Interface 

■ MPU-6050 Six-Axis Gyro 
and Accelerometer 

■ 3 Mini Push Button Switches 
■Veroboard 

■Velcro strap 

■ 1m Ribbon Cable 


This robotic arm is one of the most used 
ones and there are tonnes of guides for it 

One of these buttons controls the light 
on the end of the robotic arm, while the other 
two open and close its gripper 
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How I made: 
Robot Arm 

to grips with natural motion control 


What first inspired you to begin your 

robot arm project? 

The robot arm itself was one I’d seen 
years ago and I really wanted it because 
it’s something you can control yourself - 
it really captured my young imagination. 
I was volunteering at a science museum 
down here in Harlow and this club based 
around the Raspberry Pi sprung up, and I 
bought the robot arm because I wanted it. 
So then I had the Raspberry Pi thing going 
on at the same time and thought, why not 
meld the two? 

I had this complicated system of key 
presses to get it to do anything, which 
was a bit boring, and then James Dali 
(one of the people who helps out with 
the club) gave me the idea of shoving an 
accelerometer on the top of it to give an 
idea of where it is. I took that and thought, 
‘What if I had the accelerometer on me 
and sort of used it to mirror the motion of 
my hand?’ So I looked around, searched 
up the accelerometer he was using (the 
MPU-6050) and then found it for about 
£5 on eBay - it’s normally about £30 from 
SparkFun but I’m on a student budget... 
A lot of the code I’ve used is borrowed 
but open source, and people have said 
it’s fine, so then I went through and had 
two programs - one that could control 
the arm, one that took the input in from 
the accelerometer - and kind of just 
smushed them together. It’s not that nice 
to look at, but it works and that’s all that 
really matters. 

So what exactly are you readingwith 
that MPU-6050? 

There’s the gyroscope and the 
accelerometer in the code I’d found - 
you can use one or the other, but the 
gyroscope is very good for degrees 
over time and it tends to drift, while 
the accelerometer is good for sudden 
turns and for measuring gravity. If you 
compare the two to each other then you 
can get a rough angle all of the time, so 
it’s essentially the accelerometer and 
the gyroscope used together to correct 
the faults with one or the other. It’s got 
two axes of motion - pitch and roll. 


Take us through the code itself. 

So in the first bit it finds where the 
actual I2C interface is and there’s a quick 
setup - I’ve got three buttons on there 
to control the gripper and the lights, so 
it sets those up - and then there’s a bit 
which is using the USB library to find the 
robot arm, then spitting it out if that’s an 
issue. There are a couple of definitions 
for some functions to actually move 
the arm, so it’s a little bit easier - each 
motor direction is a different binary 
number - and then there are more 
definitions for setting up reading data 
from the accelerometer and a bit of 
maths for making sure the gyro and 
the accelerometer are both giving the 
correct angle. Then there’s this while 
loop with a try inside it that is just pulling 
the accelerometer for data, spitting out 
the maths stuff , before just checking 
that the angle given is within a certain 
range. If it is, move this motor left (for 
example), or if a button is pressed then 
it turns a light on. The only problem I’ve 
had with it is that to actually move it, it 
requires a change in angle - so there’s 
not a continuous thing. I have to wave my 
hand a little bit, but there’s that degree 
angle and if I trip it then it’ll move around. 

Have you considered adding any more 
forms of control? 

Yeah, I’ve done a lot of research into this. 
In terms of other ways to control it, I quite 
like the intuitiveness of it - to rotate 
and move this arm you are moving your 
own arm, so that’s something I’ve been 
focussing on and trying to get even more 
intuitive. Trying to get some sort of - I 
bought an Arduino at some point - trying 
to build an actual robotic hand and then 
spreading out from there. Eventually, 
my big plan - many, many years in the 
future - is to have an entire sort of human 
body that is controlled by the movements 
of the user, but that’s a very large plan 


which I haven’t put too much into just 
yeti But essentially, the prototype that 
people have done before is sort of having 
pot sensors - potentiometers - on 
the fingers just to measure the actual 
rotation and closing of the fist, then 
having that represented with servos 
and then possibly doing that with actual 
pieces of string to sort of emulate the 
tendons. So you’d have a single servo, ora 
couple of servos, in an arm bit that would 
pull string which would close each finger 
in turn. 

Another idea, which seems to be 
one of the most viable, is having it 
completely brain controlled... There’s 
a fair amount of interest in reading 
brain activity - you can do it with the 
NeuroSky, for example. There’s quite a 
nice open source project which I might 
end up using because it has four inputs, 
so you can measure at least two things 
at once and that seems to be a fairly 
interesting place to go. It’s expensive 
though, and if you’re going open source 
then they have a lot of warnings on the 
websites saying that you do this at your 
own risk, this is not a medical product, 
you mayfry your brain... 

What is the next step then? 

Further projects would probably be 
replacing the motors. Because it’s 
motor-driven, it’s timing-based, so 
having something with servos instead 
where I can have a definite angle would 
be a lot more useful, a lot more precise 
and wouldn’t tend to go... one of the 
problems with it is that if you tell it to 
keep going in one direction, it will keep 
going in one direction whether it wants 
to or not, and there’s this awful grinding 
of gears as it attempts to go in one 
direction and can’t. So that will probably 
be a new arm, a new robot, trying to get 
it to be a bit more nice-looking and a bit 
more precise. 


^Another idea is having the arm be 
I completely brain controlled 



Joseph 
■ nomas is a 

Student helpingto 
run a Raspberry Pi 
clubfrom a science 
museum in Harlow, 
where they have 
worked on projeots 
rangingfrom a robot 
arm to a portable Pi. 

Like it? 

The robot arm that 
Joseph is using can 
be bought from 
Maplins in the UK 
(bit.ly/1Da9BrT) 
orordered from 
Adafruit elsewhere 
in the world (bit. 
ly/lyXlDQt). There 
are many guides 
online to get you up 
and running, suoh 
asthis one: 
bit.ly/IAKdOOU. 

Further 
rea F'F' 

NeuroSky has a 
whole product 
family dedicated 
to EEG and ECG 
biosensors, 
includingthe 
popular MindWave 
headsets (neurosky. 
com), and there 
are a few hacks 
available too (bit. 
ly/1C7wOSP). 
OpenBCI isa 
burgeoningopen 
source project 
dedicated to brain- 
computer interfaces 
(openbci.com). 
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Make a Raspberry 
PI2HTPC 


Rnally create a more powerful and capable 
HTPC using the Raspberry Pi 2 and the excellent 
OpenELEC project 



We know people who just have a Raspberry Pi for XBMC, 
now called Kodi. It’s a great idea and a great use for the Pi 
- it works just well enough that you can easily play media 
locally or over the network. The biggest issue came with 
GUI response on the original Model Bs, and a lack of USB 
ports for connecting up everything that you want. 

While optimisation over the last few years has helped, 
the leap to Raspberry Pi 2 has basically solved all of these 
problems by giving you much more powerful hardware to 
play with. So if you’re looking to upgrade or finally take the 
plunge, this handy guide will help you create the perfect 
Raspberry Pi 2 HTPC. 


Choose the software 

1 In the past. Pi HTPCs were just a choice between 
RaspBMC and OpenELEC. However, RaspBMC is on a bit of a 
hiatus and OpenELEC is your best bet for getting the most up- 
to-date software. There’s not a massive difference between the 
two, as they both run XBMC. 


Get the software 

Head over to openelec.tv and look for the Download 
section. There's a specific Raspberry Pi section which is split up 
into original (ARMvB) Pi and the newer Raspberry Pi 2 {ARMv7). 
Grab the image file from this page for the Pi 2. 


What youll need 

■ OpenELEC openelectv 

■ HDMI cable 

■ USB IR receiver 

■ IR remote 

■ Case 

■ Dedicated power supply 

■ Optional USB storage 
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Install to card 

Open up the terminal and use fdisk -I to determine where 
your SD card is located on your system. Something like /dev/sdb 
or/dev/mmcblkO will be ideal. Navigate to the image using cd and 
install it with dd using: 


I $ dd bs=lM if=0penELEC-RPi2. arm-5.0. 5. img of=/dev/ 
mmcblkO 



Above Kodi really is 
designed to be used 
with a remote, and 
there are some great 
guides to usingthem 
on the OpenELEC 
site: bit.ly/IBOAERv 


04 


First boot 

Plug in your Raspberry Pi, either to your TV or to 
another screen just to begin with, and turn it on. OpenELEC 
will resize the SD card partitions and write a few extra 
programs before finally booting into Kodi. 


06 
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Configure Kodi 

Go through the basic wizard to get through the 
interface - if you are connecting via wireless you will need 
to go to OpenELEC in the System menu and activate the 
wireless receiver before selecting your network and then 
enteringyour password. 


Add network shares 

You can stick a portable hard drive or USB stick into 
the Pi for storage, but the best method is really to stream 
over the network. Go to File manager under System and Add 
source. Go to Browse and choose your network protocol to 
browse the network or alternatively, add it manually. 

Build your media centre 

\/# Placement of your Raspberry Pi is important. As it’s 
going to be out all the time, we highly recommend getting a 
case for it - the Pibow cases from Pimoroni are quite well 
suited for this type of use as they are sturdy and oan be 
attaohed to the rear of some TVs. 

iR sensors and controllers 

Kodi can be controlled with a number of different 
things - including USB game controllers and compatible IR 
sensors. We’ve used FLIRC in the past, but if you have your Pi 
behind the TV, you’ll need a sensor on a wire that can stretch 
to a useful position. 

Future updates 

OpenELEC has the exoellent ability to update itself 
without needing you to reinstall it every few months, meaning 
you won’t need to do much maintenance on it at all. Now you 
can sit back and enjoy your media much easier than before. 


Live TV 



Kodi does havethe 
ability to play live 
TVviaaTVtuner, 
and you can also 
record stuff as well 
as long as you have 
the local memory. 
The mainthing you’ll 
need to invest in is a 
compatible TVtuner, 
a list of these is 
available here: 
bit.ly/IrSmEVj 
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Make a tweeting 
wireless flood sensor 


Flood-proof your basement in just 19 lines of code, or 
easily tweak the project to create your own personalised 
alarm system. . . 


Flooding saw hundreds of homes right 
across the world underwater this year, 
and many would have benefited from 
having just that little bit extra warning. 

In order to be better prepared for floods, 
we’re going to show you how you can 
prototype your own wireless flood sensor 
in less than ten minutes. Building it 
might give you just enough warning to 
dash home from work, move valuable 
items upstairs and take the lawnmower, 
caravan and motorbike to higher ground. 
Handily, it can also be used to detect 
toilet flushes, water butt levels or any 
liquid level rise or fall at all -so it’s not just 
somethingfun totry out, it’s practical too! 

Sending tweets 

Sending a tweet used to be really easy, if 
a little on the insecure side. These days 
you need to register an application with 
your Twitter account - you do have one, 
don’t you? If not, go create one at www. 
twitter.com. At first this project can look 
a little daunting, however it can be done 
painlessly in less than five minutes, if you 
follow these steps closely! 


What youll need 

■ Ciseco Raspberry Pi 
Wireless Inventors Kit 

shop.ciseoo.oo.uk/raswik 

■ Float sensor 

shop.ciseoo.oo.u k/f loat-switch 

■ DC power supply between 
6vand 12v 


m LinkTwitterto mobile 

Make sure your Twitter account has a mobile phone 
number associated with it. In your main Twitter account, click 
the gears icon at the top-right and then ‘Mobile’ in the list. At 
this stage, just follow the instructions on screen. 

Set it all up 

With your Twitter username and password, sign in 
to https://apps.twitter.com and click on the button ‘Create 
an application’, in the name field we suggest you use your 
Twitter account name, add a space and then write ‘test’. For 
the description, just put ‘Test poster for Python’. Finally, for the 
website you can put anything you like. For example, http://www. 
mywebsite.com - but it’s important you don’t forget the ‘http://’. 

Enable reading and writing 

Since you want to be able to send tweets, click on 
the ‘Settings’ tab, change to ‘Read and Write’ and then click 
‘Update’. This might take a few seconds. 


Generate codes 

Now go back to the ‘Details’ 
tab. You will see that an ‘APi key’ and 
‘APi secret’ are visible, and that there’s 
a ‘Create my access token’ button. 
Click that button to obtain all four of the 
codes you’ll need. If you did this before 
Step 2, or it still says ‘Read’, all you 
have to do is click the button to recreate 
these codes. It really is straightforward. 

Rememberthe codes 

Earlier on ‘API’ was called 
‘consumer’, and you might have come 
across this before in examples on the 
web. We suggest copying the following 
essentials into Notepad so they don't 
get lost: API key, API secret. Access 
token and the Access token secret. 




Right The Wireless Inventors Kit enables 
you to connect a Raspberry Pi to an Arduino 
modulefrom the other side of your house 



MAKE A TWEETING WIRELESS FLOOD SENSOR 


[ Tweepy is an easy-to-use 
Python library that works great 
for accessi ng the Twitter API 


No RasWIK? 

Not to worry, using different hardware 
is always a possibility when playing 
around with the Raspberry Pi. The 
reason we chose to use the RasWIK is 
simply because everything except the 
float switch is in the box and preloaded 
with software, making it much easier to 
get up and running quickly. As a bonus 
addition, this software is also available 
to download for free. 

To build this with a conventional 
Arduino or clone, you’ll need a USB 
cable and to leave it ‘wired’, or use 
serial-capable radio modules such as 
the Xbee or APC220. We are, after all, 
only sending and receiving plain text. 

The Arduino sketch used can be 
downloaded from http://github.com/ 
CisecoPlc/LLAPSerial, while the SD 
image for the OS we used is based on a 
stock version of Wheezy, which can be 
downloaded from http://bit.ly/SfhLLI. 



m Start simple 

To get going with your flood 
sensor, simply plug in the Slice of Radio 
to your Pi and insert the preconfigured 
Raspbian operating system. 


Goto LX terminal 

Power up the Raspberry Pi, log 
in and type STARTX to start the desktop. 
Double-click the LX Terminal and type 
thefollowingintothe black window: 

I minicom -D /dev/ttyAMA0 -b 9600 



Make the connection 

Connect the float switch to the XinoRF ground pin 
(marked GND) and digital I/O pin2. Then, power up the XinoRF 
(you will see a— STARTED- displayed in minicom) 


Test the sensor sends messages 

Wiggle the sensor up and down (you should get a— 
D02HIGFI- when the sensor position is up) and seethe RXR LED 
on the XinoRF flicker with each message sent. 


Full code listing 

# Let’s set up how to talk to Twitter first 

import tweepy, serial, time 
API_key = -nrgyfORYv jii;«^ug'’ 

API_secret = ”'apo5flri(ikS2SAWtx"'m4PAi>3i-isyW7!!yAOghi:Ln4" 

Access_token = ''/i92807040- IQlSoaVOrnjSNTvJVteUSx'/ShTl-’E^vPGfyOcS/vul'; 

Access_token_secret = T :4'.i21?ioeRi;> -'' ' ■■--Ti--DN0rriL:ihY0MdCuYKkl6f:(. 

auth = tweepy. OAuthHandler(API_key, API_secret) 

auth . set_access_token (Access_token , Access_token_secret) 

api = tweepy . API (auth) 

# Open a com port (yours may differ slightly) 
ser = serial. Serial ( ’Cfr'? ' , 9600) 

# An endless loop checking for sensor alerts 
while True: 

Serialinput = ser.read(12) 
if Serialinput == " -1. j- : 

TimeNow = datetime. datetime. now() 

DS = TimeNow. strftime( s- r/-’:%S ’A ) 

AlertText = O- _ .re .;, ,s — flood sartor -.i T + DS 

print (AlertText) 

api . update_status(AlertText) 

time.sleep(10) #stop fast re-triggering 

ser.flushInputO 


InstallTweepy 

Tweepy is an easy-to-use Python library that works 
great for accessing the Twitter API. For more information or to 
check out the documentation, visit https://pypi.python.org/ 
pypi/tweepy/2.2. Type in a shell window the following: 

I sudo pip install tweepy 


Put the sensor to work 

w W Test your prototype using a regular saucepan of water. 
If you want to putyourflood sensorto real use then place it into 
a waterproof box and ensure it is mounted securely. 





Build a Raspberry 
Pi-powered Bigtrak 

Take a toy, a Raspberry Pi and a PS3 controller; add a dash of Python 
and some solder for the perfect remote-controlled gadget. . . 



■ PS3 DualShock controller 




BUILD A RASPBERRY PI-POWERED BIGTRAK 


II 


The Raspberry Pi is a small, low-cost computer designed to 
promote an interest in computing and programming - but it 
doesn't have to be straight-laced computing. In fact, in this 
article we’ll be showing you how you can use it to turn a Bigtrak 
into a robot. That’s educational, right? 

The Bigtrak is a toy that takes in a list of straightforward 
commands (Go forwards, turn left, turn right) and then 
executes them. To make things more interesting we’re going to 
remove the existing circuitry and replace it with a Raspberry 
Pi, using a small motor driver to safely control the motors 
in the Bigtrak, which we’ll then set up to be controlled via a 
PlayStation 3 DualShock controller. 

Everything required on the software side comes pre- 
installed on the latest Raspbian OS images, so all we need to 
translate changes from the controller to the motors is a small 
Python script that uses the Pygameand RPl.GPIO modules. 

Opening up the Bigtrak - the easy bit 

\0 I Before we can make any changes to the Bigtrak we need 
to get inside. First, flip the Bigtrak upside down and remove the 
nine screws from around the edge. These are mostly easy to get 
at, however the ones on the front may require a more slender 
screwd river to reach them . 


Opening up the Bigtrak - the fiddly bit 

The last two screws are located underneath the grey 
grille on the back. This grille is held in place by four plastic 
tabs that need to be pushed in while at the same time sliding 
the grille away from the Bigtrak. This can be quite tricky as 
there is limited space to get extra hands in to help out. It can 
help to wedge some thin plastic items (eg a guitar pick) into 
the sides to keep those two tabs unlocked, while using your 
fingers to push in the bottom two tabs and slide the grille 
upwards, allowing you to remove the screws. 

Removing the top 

Put the Bigtrak back onto its wheels then carefully 
loosen the top and lift upwards. The lid is connected to the 
base with a ribbon cable and a switch, so only pull the top up far 
enough for you to tilt it to one side and expose the inside. 

With the lid lifted up onto one edge, remove the screw 
holding the switch in place and detach it from the lid. Next, 
you need to unscrew the two screws on the PCB that hold the 
ribbon cable in place and let it slip free. 

With the switch and ribbon cable disconnected, the lid 
should now come free and can finally be completely removed 
from the base of the Bigtrak. 

M Cut the wires 

Cut the wires leading to the main PCB. The ones for 
the switch and power should be cut close to the PCB (so we can 
reuse them later) whereas the ones to the LED and speaker can 
be cut wherever you like. 


Remove the engine 

Turn the Bigtrak upside down and remove the four 
screws holding the engine in place (this will reduce the chance 
of soldering iron damage to the main body). Carefully turn the 
Bigtrak back over and lift it up until the engine slips free. 








^^^^JHARDWARE 

[ The wires need to be long 
enough to reach the back of the 
Bigtrak, so be generous! 



Rewire the motor 

Remove the solder connecting the PCBtothe motors (a 
solder mop is useful here) and then remove the PCB. With the 
PCB removed we can now attach wires to the motors in order to 
drive them from the Raspberry Pi, as opposed to the on-body 
commands. The wires will need to be long enough to reach the 
back of the Bigtrak, so be generous - after all, it’s far easier to 
trim long wires to length than replace short wires entirely! 

Having installed all of the wires, you oan now replaoe the 
engine back into the Bigtrak. 
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Connect the motor driver 

With the motors back in place we now need to build 
up a cirouit to drive it from the Raspberry Pi. We've used a 
ribbon cable to connect the GPIO pins on the Raspberry Pi to 
a breadboard, before connecting it up to a Dual Motor Driver 
{http://proto-pic.co.uk/motor-driver-1a-dual-tb6612fng) to 
actually drive the motors. This keeps the higher voltage the 
motors require away from the sensitive GPIO pins. 

The connections made on the breadboard are listed in the 
table below. These values will be needed when writing the 
software and may be different depending on the breakout 
board you are using, and the Raspberry Pi revision. 


RPiGlPO 

Motor Driver 

24 

AIN2 

17 

AIN1 

18 

STBY 

21 

BIN1 

22 

BIN2 


With the PWMAand PWMB pins directly connected to the 3.3V 
power rail, the motors will now always run at full speed for as 
long as they're active. 

Install the breadboard 

The breadboard is going to be installed on top of the 
battery compartment inside the Bigtrak, so the wires from the 
motors should be brought to the back to the unit and cable-tied 
into place. The wires to the batteries can also be brought back 
tothesame place to help keep things tidy. 

Wire It all together 

In order to easily connect the motors and batteries to 
the breadboard we have soldered some modular connector 
plugs to the ends of the cable, allowing them to just push 
into place (these are available from www.maplin.co.uk/ 
modular-connectors-5348). 

With the breadboard installed (sticking it into place 
for support) we can now, after double-checking all the 
connections, plug the motors and power into it. To know when 
the motors are enabled (and reduce the chance of unexpected 
movement), the LED can be connected to the breadboard so 
that it lights up whenever the ‘standby’ pin is active, using a 
resistor to ensure it doesn’t pull too much current and go ‘pop’. 

Provide power 

l\/ Power for the Raspberry Pi is supplied via a USB battery 
pack that is installed on top of the engine and can be held 
in place by a couple of cable ties or a Velcro strip. This type of 
battery is typically sold as a portable mobile phone or iPad 
charger - the one used here is rated at SOOOmAh, able to 
powerthe Raspberry Pi for up to eight hours. 




BUILD A RASPBERRY PI-POWERED BIGTRAK 
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Connect to the Raspberry Pi - adding cables 

I I As the Raspberry Pi will be mounted on the top of the 
Bigtrak, we need to run the ribbon and power cable through 
the top of thecase. Todothis, turn the top of the Bigtrak upside 
down and release the front two catches that hold the dark grey 
plastic in place - this provides a big enough gap to feed the 
ribbon cable and USB power cable through. Make sure that 
the red edge of the ribbon cable correctly matches up with the 
connector on the breadboard to save yourself from having to 
twist the cable inside the case. 




Connect to the Raspberry Pi - final steps 

With the top of the Bigtrak back on, the Raspberry 
Pi can now be put in place, keeping the GPIO pins towards 
the front to allow the ribbon cable to easily connect. As for 
the battery pack, we’re holding it in place with cable ties 
and sticky pads. In theory it’s possible to attach the bare 
Raspberry Pi to the Bigtrak, however this can cause the SD 
card to press againstthe edge and bend, so it’s recommended 
to use a case to protect the Raspberry Pi. 

Connect the ribbon and power cable to the Raspberry Pi, 
turn it on and it’s now ready to be told what to do. For setting 
up the software it may be easier to connect up a keyboard and 
monitortothe Raspberry Pi atthis point. 


ConnectthePSS controller 

Iw This should be a simple case of plugging the PS3 
controller into one of the USB ports, as all the software to 
support it is included in the default Raspbian OS image and it 
will be automatically detected as a joystick. To confirm that the 
PS3 controller has been detected, run Isusb and checked that 
it appears in the resulting list. 


M Ru n the software 

Now with the system all set up, it should just be a 
simple case of copying the ‘bigtrak.py’ file found on this 
issue’s disc onto your Raspberry Pi and running it. As the 
script accesses the GPIO pins, it will need to be run as the 
superuser, so launch it using: 

I sudo python bigtrak.py 

Now we can control the Bigtrak using the analogue sticks! 
Moving the left stick will control the left motor and moving 
the right stick will control the right. So, to move forwards push 
both sticks up, pull both down to go backwards and push one 
up and one down to rotate on the spot. 

If the analogue sticks are not controlling the Bigtrak as 
expected, double-check the GPIO connections to make sure 
that they are all as expected. 


Next steps 

Now that you have a solid base for 
your Raspberry Pi robot, you can make 
further adjustments to it. Possible next 
steps could be: add a USB Bluetootl 
adaptor so the PS3 controller can 
be connected wirelessly; replace 
the breadboard with a PiPlate 
or 'Slice of Pi’ add-on board, 
allowing the Raspberry Pi to be 
installed inside the Bigtrak; connect 
up the RaspberryPi camera and a USB 
WiFi adaptor to stream video as you drive 
around; or add a robot arm! 






USB plugins you can make your 
own gun attachments and program 
them usingthe API to fire upon 
enemies in the Ubotia app 


Live video Usingthe Pi camera 

module, the Ubotia software is 
runninga Live video stream from the 
PiPantherto the game interface 


Components list 


4x3D-printed chassis pieces 
Raspberry Pi Model A+ 
PiPanther mainboard 
Raspberry Pi camera module 
Lithium-Polymer battery 
2x DC motors 
H-Bridge(2x3A) 

Servo 
USB hub 

2x USB attachments 
Wi-Fi dongle 


How I made 
PiPanther 


battle your friends in augmented reality 


Tell me more about your hackable 

gaming tank. 

The PiPanther robot is a smart, 
fast vehicle that you control using 
the Ubotia app on your smartphone. 
As it explores rooms, you can set up 
battlefields anywhere and fight your 
friends usingthe Ubotia software. Plus 
you can customise the tank with your 
own attachments. Unfortunately, we 
were only able to make around 22% 
[€5,000/$5,900] of our Kickstarter 
fund-raising goal. It’s just not enough 
for a large production run. 

Have you got any further plans for 
PiPanther, once the Kickstarter 
campaign has come to an end? 

Well it’s not 100 percent ready - I 
mean, it is ready but it needs a little 


more work. When working on it I found 
several issues that needed to be fixed, 
both mechanical and electronic. My 
colleague and I (the electronics guy) 
spent hundreds, if not thousands of 
hours on this project but still more 
needs to be done. To be honest, 
the biggest problem is the casing - 
this white casing is 3D-printed, but 
because I designed it using relatively 
thin and highly precise elements, I 
couldn’t use the cheaper 3D printers 
that you can buy for a few hundred 
pounds. Instead I had to order the 
casing in from a specialised company 
that used selective laser sintering. So 
it’s more expensive and the casing is 
very, very precise, but that expense is 
not acceptable for the production of 
the PiPanther on a large scale. 


So what makes up the PiPanther - 
what are the main components? 

Currently the chassis consists of four 
elements. Then there’s a Raspberry 
Pi, our PiPanther mainboard on top of 
that, two DC motors, two gearboxes, 
the tracks, one servo to rotate the 
turret. Then inside the turret there’s a 
mounted USB hub, because I designed 
PiPanther to use the Raspberry Pi 
Model A+, since it’s smaller and 
cheaper, but it only has one USB port. 
So on the turret you have two USB 
plugins and then the third USB port 
is for the Wi-Fi. We also have a Li-Po 
battery at the bottom of the chassis. 

Can you tell me more about the 
PiPanther mainboard? 

We designed it ourselves - it’s half 



Michai 

O' ulski is a 
professional C# 
software developer 
with a masters 
degree in Computer 
Science from 
Adam Mickiewicz 
University. He 
loves to work on 
projects combining 
innovation, robotics, 
electronics and 
mechanics. 



HOW I MADE: PIPANTHER 



Recharge This panel flips right 

up to reveal a microUSB port beneath, 
so you can easily recharge Pi Panther 
between rounds 


the size of the Raspberry Pi and on it 
you have a DC-DC converter, which 
supplies 5V to the Pi, powerful motor 
drivers, a servo controller and a USB 
charger, so you can charge PiPanther 
directly using a microUSB cable - just 
plug it in, leave it for three hours and 
it’s charged. 

This mainboard isgoingto be available 
separately for use in custom projects 
- is that right? 

Exactly. To drive a tank, you need 
to drive two motors - the left track 
and the right track - but instead of 
using tracks you can just use two 
wheels, so you can build your own 
wheeled robot instead. The steering 
is exactly the same. If you want to 
go forward then you power the two 
motors and if you want to turn then 
you just regulate power between 
the left and right motors. So you 
can use this board to drive your own 
robot - just plug into your motors and 
use the same mainboard but with Pi 
and Ubotia software. The main part 


(and the hardest part) of the Ubotia 
software was to provide live video 
streaming from the PiPanther to the 
mobile interface. I made that at a time 
when nobody else was able to do it, 
but unfortunately in the meantime, 
several other robots were developed 
with video streaming as well. I didn’t 
have too much time because I have 
a small child, but you have to believe 
me - I was the first one to create a live 
video stream from the Raspberry Pi to 
Android at that time! We achieved a 
video delay of less than one second, so 
you can drive it around in real time. 

So how much of all this is being 
handled by the Raspberry Pi? 

The Pi runs Arch Linux and on that 
we have our PiPanther software, 
which is responsible for talking to the 
PiPanther mainboard using the serial 
interface, USART. Then that is used 
to control the motors, turret, status 
LEDs and give feedback from the USB 
charger. That software is written in 
C++ and also consists of a plugin 


Together we spent hundreds of 
hours on this project 





The PiPanther mainboard is built to bean extension that 
attaches directly on top of the Raspberry Pi’s GPIO pins. It can work 
with both the Model A and Model B Raspberry Pis, and is capable of 
powering your own Ubotia-playing robot 


Land a direct hit in Ubotia and you’ll damage your opponent’s 
interface (it’s about a minute into Michat’s video: biLly/1BN4kpn) 



controller. So if you have plugins then 
you can put in shared libraries that are 
loaded at runtime by this software, 
and using the API you can control 
your own attached plugins using 
standardised JSON-based protocols. 

Your website says that these custom 
plugins could affect Ubotia gameplay 
- a robotic arm for a capture the flag 
match, for example. 

Yes, currently we only have the 
standard gun plugin, but if someone is 
familiar with electronics (and I think a 
lot of Raspberry Pi fans are) they can 
easily create their own plugins. I put a 
lot of effort into making the API user 
friendly. You can create, for example, 
an LED torch to replace one of the 
gun attachments and you can then 
drive around in the dark wherever you 
want - under your bed, behind your 
wardrobe - and hide to create sniper’s 
nests. Or you could create a simplified 
robotic arm for the back of the tank 
to throw other tanks, knock them 
out of the game area. You can also 
make game elements like a landmine: 
you can create a small box that uses 
the same mechanism as the guns 
(infrared) and then put it in the arena 
so it explodes when people go near it. 


Find out how 
to make your 
own PiPanther 
plugin and see a 
breakdown of the 
plugin architecture 
over at ubotia. 
com/posts/plugin- 
specification. Keep 
an eye on the main 
PiPanther page for 
any updates on 
the project. 


'e. 

Ifyou’rethinkingof 
making your own 
custom Ubotia 
robot, you can find 
ourguideto building 
and controlling 
Raspberry Pi- 
powered cars inside 
Raspberry Pi The 
Complete Manual 
(bit.ly/1xg2vuQ), 
along with plenty 
more besides. 




HARDWARE 



photo frame 

Take your Raspberry Pi, HDMIPi and Screenly and 
turn them into a beautiful digital photo frame 



Whafyoullneed 

■ Raspberry Pi Model B 

■ HDMIPi kit 

■ Class 10 SD Card 

■ 5.25V Micro USB power 
supply 

■ USB keyboard 

■ Wi-Fi dongle 

■ Internet connection 


Digital signage is a huge market in modern times, and 
increasingly we are seeing digital advertising in the public 
space - be it on street billboards, shopping centres and even 
in some city taxis. Screenly is an exciting piece of software 
from Wireload Inc that has set out to reduce the barriers to 
entry of the digital signage market by employing a Raspberry 
Pi as its main hardware component for the individual signage 
nodes. With the powerful VideoCore IV graphics processor at 
the heart of the Pi and its low electrical power consumption, 
using it as a digital signage platform is a no-brainer. 

Our expert has been using Screenly a lot recently for some 
projects and it truly is a really great piece of software. He was 
also one of the first backers of HDMIPi on Kickstarter, and when 
his reward arrived recently it occurred to him that, together 
with Screenly, it would make the perfect home-brew digital 
photo frame and another great Raspberry Pi-based hardware 
project. In this tutorial, we will show you how to assemble this 
powerful hardware/software combi nation for yourself. 


Orderyour items 

1 If you haven’t already got them 
in your Raspberry Pi collection, you will 
need to order all of the items from the 
“What you'll need’’ list. The HDMIPi is 
currently only compatible with Model B 
of the Raspberry Pi, although a Model 
B-l- version is in the works (the B-l- 
does actually work with HDMIPi, but 
unfortunately cannot fit into the case). 
Pretty much any USB keyboard will 
work with Screenly, including wireless 
ones, so you do not need to worry about 
a mouse for this tutorial as it will all be 
donefrom the command line. 

Finally, a speaker is only necessary 
if you intend to play videos from the 
display with sound as well. 




MAKE A DIGITAL PHOTO FRAME 





Assemble your HDMIPi 

The HDMIPi comes as a do-it-yourself kit rather than 
a polished product. Not only does this make it cheaper for you 
to buy, but it also gives it a more hack-like feel in its Pibow- 
esque acrylic layer case. It is not hard to assemble, but in 
case you get stuck there is a fantastic assembly video here: 
http://hdmipi.com/instructions. 



Download Screenly OSE 

Now that you have the hardware all ready to go we need 
to download the Screenly OSE SD card image. This is only a 3.7GB 
image file, however it may not fit on some 4GB SD cards so we 
would recommend a minimum of 8GB, for extra space for all your 
pictures and videos. Visit bit.ly/lwLKIRQ and download the ZIP file 
from one of the mirrors under the “Getting started” heading. 

Flash image to SD Card (Linux) 

It’s worth noting the value of having a Linux machine 
at your disposal (or a spare Raspberry Pi and SD card reader) 
to download the ZIP file in Step 03. This is typically the easiest 
way to unzip the file and copy the image across to your SD 
card. Assuming the disk isn’t mounted, open a terminal 
session and type: 

I unzip -p /path/to/screenly_image.zip | sudo dd 
bs=lM of=/dev/sdX 

Make sure that you replace /path/to/screenly_image.zip with 
the actual path. 



Flash image to SD Card (Other OS) 

If you do not have another Linux machine handy, or 
a card reader for your Raspberry PI, you can still do this from 
other popular operating systems. On Windows you should use 
Win32 Disk Imager and follow the easy to use GUI. From Mac 
OS X you have the options of using the GUI-based software 
packages PlWrIter and Pi Filler, or running some code from the 
command line. Visit www.screenlyapp.com/setup.html for 
more info. 

insert SD card and peripherals 

Once the Screenly image has been successfully 
transferred to your SD card, you will need to insert it into the 
Raspberry Pi within your HDMIPi casing. 

It is a good idea to connect your Wi-Fi dongle and keyboard 
at this point. Take a look at the image at the top of this 
page to see where the slots are in relation to the casing. A 
wired network is also required for the initial setup and for 
configuringthe Wi-Fi connection. 

Boot up your Raspberry Pi 

The HDMIPi driver board has a power output for the 
Raspberry Pi which means you only need one power supply for 
this setup. Plug it in and wait for it to boot into the Screenly splash 
screen. An IP address (of format http://aaa.bbb.ccc.ddd:8080) 
should bedisplayed here, which will allow you to gain access to the 
management dashboard. 








Above The reverse 
view of HDMIPi, 
showing GPIO and 
connector cutouts 


History of 
HDMIR 



HDMIPi isa 
collaboration 
between Cyntech 
and Alex Eames 
from RasPi.TV.They 
wanted to bringa 
cheap HD resolution 
HDMI screen to the 
market that will 
reducethecost of 
having a dedicated 
monitorforyour 
Raspberry Pi. They 
tookto Kickstarter 
to launch theiridea 
(kck.st/17zyaQg) 
and there was a huge 
responseto this 
project from both 
within and outside 
the Raspberry Pi 
community. Over 
2,500 people from 
all overtheworld 
enabled them to 
smash their£55,000 
target, and the 
campaign finished 
with over £260,000. 
UNICEF even 
thoughtthey were 
good enough to use 
in their educational 
projects in Lebanon 
(bit.ly/ZDp08Z). 




HARDWARE 



Above Screenly Pro 
can manage multiple 
screens and has 
cloud storage too 



Schedule Overview 


Screenly 
Pro Edition 



Inthistutorialwe 
have used the open 
source version 
of Screenly- 
ScreenlyOSE.This 
is a fantastic bit 
of software and a 
great addition to 
the open source 
ecosystem. At this 
point, some of you 
may bedreaming 
of huge remote- 
managed display 
screen networks 
and the good news 
is thatthis is entirely 
possible with 
Screenly Pro. This 
iscompletelyfree 
for a single display 
screen and 2GB of 
storage, and it has 
larger packages for 
purchase starting 
at two screens right 
upto 130+ screens. 
It also adds a lot of 
additional features 
not seen in Screenly 
OSE- find out more 
aboutthoseonthe 
Screenly website 
(bit.ly/1EXl92p). 



Disable Screenly video output 

Load the IP displayed on the splash screen on the 
browser of a different computer (you won’t be able to do it 
directly from the same Pi). The Screenly OSE dashboard should 
now load. Once inside the dashboard, move the slider for Big 
Buck Bunny to theOFF position or delete the asset entirely. 

Enterthe command line 

Once you have disabled the Big Buck Bunny 
trailer from the web interface, you should now be able 
to enter the command line easily and you can do this by 
pressing Ctrl+Alt+FI on the attached keyboard at any 
time. Alternatively, you can access the command line 
over SSH using the same IP address as shown previously 
on the splash screen. 


Run the update script 

The image file we downloaded from the website is 
actually just a snapshot release and does not necessarily 
include the latest Screenly OSE code, as the code updates 
are made more regularly than the image. It is therefore 
good practice to run an upgrade to the latest version using the 
built-in script. You can run the following command: 

I ~/screenly/misc/run_upgrade.sh 


Configure Raspberry Pi 

1 1 Once you are successfully at the command line, you need 
to type sudo raspi-config to enter the settings and then select 
‘1 Expand root file system’ to make sure you have access to all of 
the space on the SD card. Then, change the time zone (option 4 
and then 12) so that it is correct for your location. If your screen 
has black borders around the edge you may also need to disable 
overscan (option 8 and then A1). We would also recommend 
changing the default password to something other than 
raspberry to stop any would-be hackers from easily accessing 
the Raspberry Pi via SSH (option 2). Once complete, exit without 
restarting by selecting Finish and then No. 


Enable and set up Wi-Fi 

As Screenly runs on top of Raspbian, the Wi-Fi setup 
is essentially the same as the standard command line 
setup within the OS. In order to do this you need to edit the 
interfaces file using sudo nano /etc/network/interfaces 
and then type in the following code, replacing ssid and 
password with the actual values: 

I auto lo 

I iface lo inet loopback 
iface eth0 inet dhcp 

I allow-hotplug wlan0 
auto wlan0 

I iface wlan0 inet dhcp 
wpa-ssid “ssid” 
wpa-psk “password” 

I iface default inet dhcp 


Then exit and save by hitting Ctrl+X, then Y and then Return. 




MAKE A DIGITAL PHOTO FRAME 





Access 
Screen [y 
from afar 


The default Screenly 
image is essentially 
some additional 
software running 
on top of Raspbian 
OS. This means that 
SSH is enabled by 
default (it’s why we 
changed the default 
password in Step 11) 
so it’s now possible 
to access the 
command line, as 
well as the Screenly 
dashboard, from 
outside of your LAN. 
We recommend 
setting a static IP 
foryourScreenly- 
powered Raspi 
from your router 
settings and then 
setting up SSH with 
keys on your Pi, and 
port forwarding 
on your router 
for ports 22 and 
8080. The Screenly 
dashboard has no 
login so anyone 
can access it, but 
an authentication 
feature is imminent. 


Above Once fully configured, load 
your pictures and video to complete your 
digital photo frame! 

1 C with video and more 

1^# Pictures are great, but Screenly also allows you to display 
videos (with audio if you wish) and web pages, which really is a 
huge benefit. This is perfect if you want to enhance your digital 
photo frame even further or perhaps display the local weather 
and news to keep yourself informed. Plug in your speaker - we 
would recommend The Pi Hut portable mini speaker (available 
from bit.ly/lxEpBNZ) or anything similar. 

Place in situ and enjoy! 

1^/ Once you have got Screenly all set up and loaded all of 
your favourite pictures and videos onto it via the web interface, 
it is now time to enjoy the fruits of your labour! Mould the spider 
stand (if you have one) into shape by taking the middle two legs 
at the top and bending them downwards and backwards. Then 
spread the front-middle legs a bit wider to give a good base and 
shape the outer legs at the top and bottom to support the screen. 
You are then ready to give it its permanent home - our expert’s is 
on the mantelpiece over the fireplace! 

other project ideas 

I# In this tutorial we have looked at Just one fairly basic 
application of Soreenly and the HDMIPi. You could use this 
powerful open source software to run your digital signage empire, 
share screens in schools and clubs, or as a personal dashboard 
using a suitable web page. Whatever you make, please don’t forget 
to take pictures and send them to us! 


lO Test the connection 

1%^ The easiest way to test the Wi-Fi connection is to shut 
down the Raspberry Pi using sudo shutdown -h now and then 
remove the wired network connection and reboot the Raspberry 
Pi by removing and reattachingthe microUSB power connector. If 
the Wi-Fi connection has worked, you should now see the splash 
screen with IP address again. 


Add Asset 


M Upload pictures to Screenly 

Once again, you will need to visit the Screenly OSE web 
interface by entering the IP address into another oomputer. 
Since you are now using a wireless connection, the IP address 
may be different to the previous one. You need to select the 
Add Asset’ option at the top right-hand side, which should 
launch a pop-up options screen. Select Image from the drop- 
down box and you then have the option of either uploading the 
image or grabbing it from a URL using the corresponding tabs. 
Enter the start date and end date of when this image should 
appear, and how long it should appear on screen for, then press 
Save. Repeat this step for eaoh of the pictures. 



HARDWARE 


Cup-on The attachment clips on 
to your regular prescription glasses or 
sunglasses, so you don’t have to worry 
about sacrificingyour ability to see 


Video display Thetiny screen 
on top of your glasses provides a 320 by 
240 display and feels like you’re looking 
at a 52-inch screen a few feet away 


Casi ng AU the components taken 
from the original video glasses have 
been rewired and then sealed in this 
eight-piece, 3D-printed enclosure 


Power If you wantto use Pi Glass 
on the go then plug it into a portable 
USB battery pack. The Ruiz brothers 
mounted it onto a belt: bit.ly/IHDjIyS 


The Pi Glass attachment is affixed 
to your regular glasses using the small 
clip on the inside of the central block 

These video glasses cost about 
$110/£70 and, while not exactly suited 
for long-term use, they’re perfect for 
repurposing into other optical projects 
likethe Pi Glass 






HOW I MADE: PI GLASS 



r How did you get started with Adaf ru it? 

Noe It was about a year ago, we 
came on their show-and-tell and we 
wanted to show people what projects 
we were working on. At the time it was a 
simple wearable project - a 3D-printed 
belt buckle with Adafruit LEDs and 
their GEMMA microcontroller, so the 
thing there is mixing self-expression 
and design with the electronics and 
making it flashy and cool. Adafruit liked 
that, and what they liked even better 
is that we make videos as well, so Phil 
[Torrone], a cofounder of Adafruit, 
wrote to us asking if we’d like to be 
an author on their Adafruit Learning 
System. We said sure, we can write 
documentation, but we can also do 
video. And that led to starting another 
project and it gained momentum from 
there, and every week we’ve been 
coming out with a new 3D-printed 
project since. Recently it’s been getting 
much bigger, and it’s always a challenge 
because every week we’re upping our 
skills - it’s like, can we design that, 
will that print? So far it’s been more 
successes than failures. We do a good 
job learning from the bad stuff and 
capturing the really good stuff and 
telling people in our guides how to keep 
moving on. It’s very hard stuff but we try 
to make it look like it’s not so hard so 
that people try it out and learn from it. 

We try to make the guides as 
repeatable as we can - step-by-step 
guides that are easy to use. 

It’s so open sourcey! We had no idea 
of the open source hardware movement 
and it’s completely empowering to give 
away our design files. When we started 
out as Pixil 3D we really didn’t give away 
our designs - we’d hold on to them 
because it was our stuff. But now it 
makes so much sense to give them away 
since you have that incentive to. It’s like 
hey, here’s a cool project idea - just buy 
some parts and then follow along with 
our circuit diagrams and tutorials. 

It really speaks to what 3D printing 
is becoming; it’s the shell that holds all 
the components that bring it to life. 


How I made: 
Pi Glass 

a Kaspberry Pi to hack video gogges 


So what exactly does your DIY Glass do? 

N;n; The idea was sort of inspired 
by Limor [Fried] herself - she has 
these hundred-dollar video glasses 
on the shop and she said: “You know 
what? Let’s take it apart. Let’s take 
the guts out, the actual circuitry, and 
make a new format for it. Instead of 
being two glasses let’s make it clip 
on to your existing glasses kinda like 
Google Glass, but let’s make it for the 
Raspberry Pi.” So that was the original 
idea and it was rather simple because 
there really wasn’t much programming 
or software involved - it was just 
repurposing this component inside 
this hundred-dollar pair of glasses 
and making it more Google Glassy and 
more DIY. From a design standpoint 
it was really challenging because the 
tolerances and things for that was 
kinda hard, especially for different 
machines - you’re always looking at 
different tolerances; even when you’re 
slicing it, things will come out a little 
bit differently. So that’s why it’s so 
important to give away the files and to 
tell people that you can modify it and 
you can make it work for you. And quite 
a few people have made their own and 
printed it fortheir application. 

It’s a good foundation for anybody 
who can build on top of it. So we’ve 
seen different Pi Uls that mimic the 
Google Glass Ul - this is something that 
somebody could take and sort of adapt. 

It’s a great example - so someone 
who’s not super ace at designing or 
printing but maybe has the software 
chops can take this project and make it 
even better. We’d really like to see that. 

How did you make the attachment after 
you split upthe original video glasses? 

So I guess for starters we bust out 
the calipers and we start measuring 
like crazy. From there we designed the 
components, we remake them in CAD 
- our favourite CAD right now is 123D 
Design, which is from Autodesk. We 
use it literally on a daily basis. But you 
start off by making the components 


and modelling them out, and creating 
the enclosure on top of that and just 
chiselling away and creating features, 
figuring out how to split it up into pieces 
so that it can print without any support 
material. We really strive to make our 
designs with no supports - that way you 
can get a really clean design that looks 
beautiful and doesn’t require that extra 
bit of waste. And it is 3D printing - it’s 
rapid, right? So we prototype the piss out 
of our projects! We’re so fortunate that 
we have the time to do it. It’s hard to keep 
it under two weeks, but it really feels like 
it’s a rush and we do step back and take 
the time to make sure it’s right. 

We always have a buffer of at least 
a month with projects already in the 
works and we make sure we keep the 
pipeline full - sort of like a TV schedule. 
And sometimes if we can’t finish quite 
in time, we let people know and say hey, 
you can finish this for us by all means - 
go ahead and pick up where we left off. 

How is the Pi talkingto the attachment? 

It’s just plugged in through HDMI, 
really - it’s just an add-on to the Pi 
to make it mobile. You just plug into a 
battery bank, so in that respect it’s really 
quite simple. 

Is there an easy way to control the output? 

We have a small wireless keyboard 
that we sell in the shop, so we thought 
we’d keep it as simple as possible and 
use that to control things on the Pi. 

Do you thinkthis is a project you’ll revisit? 

With the release of the A+ we 
might revisit it. Build more libraries for 
talkingto sensors and things like that 

Maybe something more enclosed 
and more specific to the Pi. We have 
a really cool remote team that does 
different projects as well, so we’re 
just now starting to collaborate with 
them because they’re more skilled and 
disciplined in software engineering, so 
it’s really cool to bring those two minds 
together - the design and videography 
and then the software engineering. 



Noe Ruiz 

has designed 
products for several 
different industries 
sincetheage of 14, 
in creative mediums 
includingUI design 
foriOS apps, 
websites and also 
audio production for 
video games 



Pedro Ri" 


has been a media 
designersince 
1999. He’s worked 
on a wide range of 
projects including 
iPhone apps, video 
games, 3D modeling, 
video production 
and social media 
content 


Like it? 

If you wantto make 
your own Pi Glass 
then checkout Noe 
and Pedro’s tutorial 
on the Adafruit 
Learning System: 
bit.ly/lfbHhfw 

Further 

reading 

To see some of the 
crazy electronic 
costumes and 
3D-printed gadgets 
that the Ruiz 
brothers make, 
checkouttheirmain 
page over at the 
Adafruit site: 
bit.ly/lyBSECn 




HARDWARE 



Build a Raspberry Pi 
Minecroft console 


Create a full-functional. Pi-powered games console that you can 
play Minecraft on and learn how to program too 

Minecraft means many things to many people, 
and to Raspberry Pi users it’s supposed to mean 
education. Not everyone knows, though, that you 
can still have fun and play M/necraftas you normally would. 

Using Raspberry Pi, it is also the cheapest way to get 
a fully-functional version of Minecraft up onto your TV. 

However, in its normal state, just being on a TV isn’t the end of 
it. Using all the features and functions of the Pi, we can take 
it to a state more fitting of a TV by making it into a hackable, 
moddable Minecraft console. 

In this tutorial, we will show you howto set it up in terms of 
both software and hardware, how to add a game controller to 
make it a bit better for TV use, and we’ll even give you some 
example code on how to mod it. Now, it’s time to get building, 
so head to Step 1. 


What youll need 

■ Raspberry Pi 2 

■ Latest Raspbian image 

raspberrypi.org/downloads 

■ Minecraft Pi Edition 

pi.minecraft.net 

■ Raspberry Pi case 

■ USB game controller 
(PS3 preferable) 




BUILD A RASPBERRY PI MINECRAFT CONSOLE 



Prepare your Raspberry Pi 

Minecraft: Pi Edition currently works on Raspbian. We 
recommend you install a fresh version of Raspbian, but if you 
already have an SDcard with it on, the very least you should do is: 

I sudo apt-get update && sudo apt-get upgrade 


If you’ve installed Raspbian from 
scratch, Minecraft is actually 
already installed - go to the Menu 
and look under Games to find it 


Set up Python 

While we're doing set up bits, we might as well modify 
Mincecraft using Python for a later part of the tutorial. Open up 
the term i nal and use: 


Updates to 
Pi Edition? 


Choose your Raspberry Pi 

I Before we start anything, everything we plan 
to do in this tutorial will work on all Raspberry Pi 
Model Bs with at least 512 MB of RAM. However, Minecraft: Pi 
Edition can chug a little on the original Model Bs, so we suggest 
getti ng a Raspberry Pi 2 to get the most out of this tutorial. 


Above Give 


Minecraft: Pi Edition 
a quick test before 
you start building 
the console 


Prepare Minecraft 

If you’ve installed Raspbian from scratch, Minecraft 
is actually already installed - go to the Menu and look under 
Games to find it there ready. Ifyou’vejust updated yourversion of 
Raspbian, you can install itfrom the repos with: 

I $ sudo apt-get install minecraft-pi 

Test it out 

If you’ve had to install Minecraft, it’s best just to check 
that it works first. Launch the desktop, if you’re not already in 
it, with startx and start Minecraft from the Menu. Minecraft: 
Pi Edition is quite limited in what it lets you do, but it does make 
room for modding. 

X setup 

If you have a fresh Raspbian install and/or you have 
your install launch into the command line, you need to set it to 
load into the desktop. If you’re still in the desktop, open up the 
terminal and type in raspi-config. Go to Enable Boot to Desktop 
and choose Desktop. 


I $ cp /opt/minecraft-pi/api/python/mcpi -/minecraft/ 

Minecraft at startup 

For this to work as a console, we’ll need it to launch into 
Minecraft when it turns on. We can make it autostart by going 
into the terminal and opening the autostart options by typing: 

I $ sudo nano /etc/xdg/lxsession/LXDE-pi/autostart 

Autostart language 

In here, you just need to add @minecraft-pi on the 
bottom line, save it and reboot to make sure it works. This is a 
good thing to know if you also want other programs to launch as 
partofthe boot-up process. 

Turn off 

For now, we can use the mouse and keyboard to shut 
down the Pi in the normal way, but in the future you’ll have to start 
turning it off by physically removing power. As long as you’ve exited 
the Minecraftvjoddi and saved, that should be fine. 








Minecraft: Pi Edition 
hasn’t received an 
update for a little 
while, but it was 
previously limited by 
the original Model 
B. Now with more 
power, there may 
be an update that 
adds more to it, but 
right now there’s no 
indication of that, if 
it does come though, 
all you need to do is 
update your Pi with: 
sudoapt-get update 
&& sudo apt-get 
upgrade. 


Getting power to the Raspberry Pi 2 
so that it runs properly can be tricky if 
you’re using a USB port 



3D-print 
a case 


Aaron Hicks at 
Solid Technologies 
designed this 
Minecraftcase for 
the Raspberry Pi 
and shared it on 
GrabCAD. We’ve 
uploaded our slightly 
modified version to 
FileSilo.co.uk along 
with yourtutorial 
files forthis issue. 
Allyou need to do is 
send theSTL file to 
a 3D printing service 
-many high street 
printing shops have 
at least a MakerBot 
these days -and 
they will3D-print 
the case foryou. 

It should only cost 
around £15. 



The correct case 

In this scenario, we’re hooking this Raspberry Pi up to a 
TV, which means it needs a case so that there's less chance of 
damage to the components from dust or static. There are many 
good cases you can get - we are using the Pimoroni Pibow here 
as you can mount it to the backoftheTV. Alternatively, you could 
get really creative and 3D-print your own case, as you can see on 
page 58. Check outthe boxoutjusttothe left. 

Find the right power supply 

Getting power to the Raspberry Pi 2 so that it runs properly 
can be tricky if you’re using a USB port or a mobile phone charger 
- the former will be underpowered and the latter is not always 
powerful enough. Make sure you get a 2A supply, like the official 
Raspberry Pi one. 


Go wireless 

We understand that not everyone has an ethernet cable 
near their TV, so it may be a good idea to invest in a Wi-Fi adapter 
instead. There is a great list of compatible Wi-Fi adapters on the 
eLinuxwiki: elinux.org/RPi_VerifiedPeripherals. 

Mouse and keyboard 

Now that we have the Raspberry Pi ready to be hooked up, 
you should look at your controller situation - do you want to be 
limited bythe wires or should you getawireless solution instead? 
We will cover controller solutions over the page, but it’s worth 
considering now. 

Get ready for SSH 

It will be easier to create and apply scripts to Minecraft 
by uploading them via the network rather than doing it straight 
on the Pi. In the terminal, find out what the IP address is by using 
ifconfig, and then you can access the Pi in the terminal of another 
networked computer usingthefollowing: 

I ssh pi@[IP address] 

Have a play 

At this stage, what we have built is a fully-functional 
Minecraft console. Now, at this point you could start playing if 
you so wish and you don't need to add a controller. You can flip 
over to page 62 now ifyou want to begin learning howto mod your 
Minecraft and do a bit more with it to suit your needs. Flowever, 
if you do want to add controller support then carry on and take a 
look at Step 16. 
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Left stick 
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L2 Right click (hit) 

LI Cycle held item 


Select PS Button Start 

Escape Connect Escape 

controller 




Directional 


buttons 


Movement 


O Escape 


Jump 

L,_ 


R2 Right click (hit) 


R1 Cycle held item 


A Inventory 


Here s the fu 


Controls 


L3/R3 


Descend 


Right stick 
Camera 


while flying 


layout of the fl 

buttons used 
bythePSS H 

controller by V 

default -you can ^ 
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download in Step 18 



Add controller support 

Make sure the controller input functions are installed 
on the Raspberry Pi. To do this, ssh into the Raspberry Pi like 
we did in Step 14 (where ‘raspberry’ is the password) and install 
the following package: 


I $ sudo apt-get install xserver-xorg-input-joystick 


Controller mapping 

I# We have a controller map for the PS3 oontroller that 
you can download straight to your Pi, and with a bit of tweaking 
can fit most USB controllers as well. Go to the controller 
conf igu ration folder with: 


I $ cd /usr/share/Xll/xorg.conf.d/ 



Reboot to use 

17 After a reboot to make sure everything’s working, you 
should be able to control the mouse input on the console. R2 and 
L2 are the normal mouse olicks and can be used to navigate the 
Minecraft menu to access the game. 



Xbox 

controllers 


Unfortunately, Xbox 
360 controllers work 
slightly differently 
with Linux. As they 
use theirown drivers 
that are separate 
to the normal 
joystick drivers we 
usedforthe PS3 
pad and other USB 
controllers, a 360 
controller doesn’t 
work as a mouse and 
is harderto assign 
specific functions to. 
This makes ittricky 
to use in a situation 
such as this. 


Replace the controller mapping 

We’ll remove the current joystick controls by using sudo 
rm 50-joystick. conf and then replace by downloading a 
custom configuration using: 

I $ sudo wget http://www.linuxuser.co.uk/wp-content/ 
uploads/2015/04/50-joystick.conf 


Go full-screen 

So far you may have noticed that Minecraft is running 
in a window - you can click the full-screen button to make it fill 
the screen, however you then heavily limit your mouse control. 
Thanks to the controller, you can get around that. As soon as you 
load the game, make sure you use the sticks for movement and 
the d-pad for selecting items in the inventory. 





HARDWARE 


Mod your Minecraft 

Here is some example code, and explanations for it, so that you con 
learn how to program In python and mod Minecraft PI 


S We program Minecraft to react in python using the 
API that comes with Minecraft: Pi Edition - it’s what 
we moved to the home folder earlier on. Now’s a 
good time to test it - we can do this remotely via SSH. Just cd 
into the Minecraft folder in the home directory we made, and 
use nano test, py to create our test file. Add the following: 


from mcpi. minecraft import Minecraft 
from mcpi import block 
from mcpi.vecS import Vec3 
me = Minecraft. createO 
mc.postToChat(“Hello, Minecraft!”) 


Save it, and then run it with: 

I $ python test.py 

“Hello, Minecraft!’’ should pop up on-screen. The code imports 
the Minecraft function from the files we moved earlier, which 
allows us to actually use Python to interact with Minecraft, 
along with the various other functions and modules 
imported. We then create the me instance that will allow us 
to actually post to Minecraft using the postToChat function. 
There are many ways you can interact with Minecraft in this 
way - placing blocks that follow the player, creating entire 


structures and giving them random properties as they’re 
spawned as well. There are very few limits to what you can do 
with the Python code, and you can check out more projects 
here: https://mcpipy.wordpress.com. 

Over the page, we have a full listing for a hide and seek 
game that expands on the kind of code we’re using here, 
where the player must find a diamond hidden in the level, with 
the game telling you whether you’re hotter or colder. You can 
write it out from scratch or download it to your Pi using the 
following commands: 

I $ wget http://www.linuxuser.co.uk/tutorialfiles/ 
Issuel34/ProgramMinecraftPi.zip 

1 $ unzip ProgramMinecraftPi.zip 

$ cp ProgramX MinecraftPi/hide_and_Seek.py -/minecraft 

Check out the annotations to the right to see how it works. 

We program Minecraft to react in 
Python using the API that comes with 
Minecraft Pi - it’s what we moved to 
the home folder earlier 


Below You can seethe hidden diamond just 
to the Left ofthe crosshair at the centre of 
this screenshot 



Well done - 86 seconds lo find the dianond 




/ 











♦ 



1 *^ 
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Import 

Here we’re importingthe necessary modules 
and APIs to program Minecraft Most 
importantly are the files in the mcpi folder 
that we copied earlier 


Full code listing 

from mcpi. minecraft import Minecraft 
from mcpi import block 
from mcpi.vecS import Vec3 
from time import sleep, time 
import random, math 


Locate 

We connect to M/necraftwith the first line, 
and then wefind the player’s position and 
round it up to an integer 


me = Minecraft. createO 
playerPos = me. player. getPos() 

rounclVec3(vec3) : 

Vec3(int(vec3.x), int(vec3.y), int(vec3.z)) 


Range finding 

Calculate the distance between the player 
and diamond. This is done in intervals later 
on in the code, and just compares the co- 
ordinates of the positions together 


distanceBetweenPoints(pointl, point2): 
xd = point2.x - pointl.x 
yd = point2.y - pointl.y 
zd = point2.z - pointl.z 

math.sqrt((xd*xd) + (yd*yd) + (zd*zd)) 


Creation 

Create a random position for the diamond 
within 50 blocks of the player position that 
was found earlier 


start 

This is the main loopthatactuallystartsthe 
game. It asks to get the position of the player 
to start eaoh loop 


Notification 

This part sets the block in the environment 
and pushes a message using postToChatto 
the M/necraftinstanoe to let the player know 
that the mini-game has started 


random_block() : 

randomBlockPos = roundVec3(playerPos) 

randomBlockPos . X = random. randrange(randcimBlockPos.x - 50, randomBlockPos . x + 50) 
randomBlockPos . y = random. randrange(randomBlockPos.y - 5, randomBlockPos . y + 5) 
randomBlockPos . z = random. randrange(randomBlockPos.z - 50, randomBlockPos . z + 50) 
randomBlockPos 

main(): 

lastPlayerPos, playerPos 
seeking = True 
lastPlayerPos = playerPos 

randomBlockPos = random_block() 

me . setBlock ( randomBlockPos , block . DI AM0ND_BL0CK) 

mc.postToChat(“A diamond has been hidden - go find!”) 


Checking 

We Start timing the player with timeStarted, 
and set the last distance between the player 
and the block. Now we begin the massive 
while loop that checks the distance between 
the changing player position and the fixed 
diamond. If the player is within two blocks of 
the diamond, it means they have found the 
block and it ends the loop 


Message writing 

If you’re two or more blocks away from the 
diamond, it will tell you whether you’re nearer 
orfarther away than your last position check. 
It does this bycomparingthe last and new 
position distance - if it’s the same, a quirk in 
Python means it says you’re colder. Once it’s 
done this, it saves your current position as 
the last position 


Success 

It takes a two-second break before updating 
the next position usingthe sleep function. If 
the loop has been broken, ittallies upyour 
time and lets you know how long it was before 
you found the diamond. Finally, the last bit 
then tells Python to start the script at 
the main function 


lastDistanceFromBlock = distanceBetweenPoints(randomBlockPos, lastPlayerPos) 
timeStarted = time() 
seeking: 

playerPos = me. player. getPos() 
lastPlayerPos != playerPos: 

distancePromBlock = distanceBetweenPoints(randomBlockPos, playerPos) 
distancePromBlock < 2: 
seeking = False 


distanceFromBlock < lastDistanceFromBlock: 

me. postToChat( “Warmer ” + str(int(distanceFromBlock)) + “ blocks away”) 
distanceFromBlock > lastDistanceFromBlock: 

me. postToChat( “Colder ” + str(int(distanceFromBlock)) + “ blocks away”) 
lastDistanceFromBlock = distanceFromBlock 
sleep(2) 

timeTaken = time() - timeStarted 

mc.postToChat(“Well done - ” + str(int(timeTaken)) + “ seconds to find the diamond”) 

name == “ main ”: 

rtHin() 



Camera 48 Raspberry Pi 
Cameras make up Bullet Pi, with each 
one sitting in the lower half of each 
piece of the frame composingthe ring 


HARDWARE 


Ring Bullet Pi uses a ring setup so 
that you can rotate around a subject 
frozen in time once the photos are 
stitched together 


Many people wondered 
if Andrew and the team were 
buildings Large Hadron Collider 
when the f i rst few photos were 
teased online 


Liz Upton, head of 
communications atthe 
Raspberry Pi Foundation, tests 
out Bullet Pi atthe Manchester 
Raspberry Jam in 2013 


PiFace The Control and Display 
module has an LED screen for two 
16-character lines, five control buttons, 
a navigation switch and IR receiver 


Cables About half a kilometer 
of network cable was used to build 
Bullet Pi - the PiFace modules were a 
godsend during debugging 


Components fist 


48 Raspberry Pi Model Bs 
48 Raspberry Pi Cameras 
48 PiFace Control and 
Display modules 
48 NOOBS SD cards 
485VPSUS 

500m of network cable 
2x24 port switches 
Wireless router 




r 


Frame Whilethe shots for 

each set of Bullet Pi images can be 
adjusted, they’re kept level with a 
custom laser-cutframe 











HOW I MADE: BULLET PI 



r What inspired you to create Bullet Pi? 

So I’d seen The Matrixand also a BBC 
programme called Supernatural: The 
Unseen Powers Of Animats, where they 
shot dolphins jumping out of the water, 
froze time, and then spun around so you 
saw the water drops, and I thought that 
was a really amazing effect. And reading 
how it was done, it was with a whole 
array of cameras and it seemed quite 
simple. So I had the Raspberry Pi and a 
couple of cameras sat on my desk, and 
it was sort of like, ‘Well, if it seems that 
simple, then surely if we just got a whole 
load of Raspberry Pis and cameras - 
and they’re not that expensive - why 
shouldn’t we just be able to build it?’ 
It was one of those moments where 
you think it should work but you don’t 
actually know. So what I did was buy 
four cameras and I tried it, and that 
looked like it would work - it gave us a 
tantalising glimpse that we could do it. 

So it was a good concept test? 

Yeah, but even so it wasn’t conclusive - 
it just told us that it’s possibly likely but 
we still didn’t actually know. So then it 
was just a case of buying a few more 
cameras. You get to the stage where 
all you can think is, ‘Right, let’s go for it. 
Let’s have a full set of 48 cameras and 
just build it’ It was only really when we 
got the first set of images out, and then 
stitched that together, that you could 
see having a whole load of cameras and 
firing them at once is pretty much all we 
needed. It was one of those things where 
‘Wouldn’t it be cool if...?’ became ‘You 
know, we might be able to...’ and then 
‘Oh, we’ve done thisi’ 

That’s where the best Pi projects come 
from! So how do you set it off? 

It’s gone through a few iterations and, 
as we’ve tried it, we’ve made a few 
refinements. In the latest setup, we’ve 
got all the Pis booted into Raspbian and, 
on boot, they run a little Python script 
we’ve got. We’ve fitted them so every Pi’s 
got a PiFace Control and Display module 
that you can have simple interactions 


I 


How I mode: 
Buller Pi 

Freeze ti le by chaining 4<j Raspberry P"= 


with using buttons - it just drives a 
menu. So that lets us know that all the 
Pis have booted up, because if you’ve 
got 48 Pis and a network cable comes 
out, it’s tricky to find out which one 
when they all look the same. So that was 
really just a luxury in terms of helping 
to debug, and it also means we can 
reconfigure the array if we wanted to do 
a lateral version. 

What are you usingto stitch the images? 

That’s FFmpeg. We’ve had to do some 
things with the alignment just to get a 
smooth video out, because some of the 
cameras are at slightly different angles 
and if you don’t then the picture tends 
to go up and down. Basically we take 
a set of images with each calibration 
and work out whether there’s a positive 
or negative offset to each frame, then 
when we stitch them together we chop 
off the top and the bottom and just use 
the middle of the frame. 

Is that handled by a script or do you do it 
manually once you’ve taken the shots? 

We actually trigger it as two points, but 
there’s nothing to stop the two scripts 
being put together in the command 
line and all being run at once. The only 
reason we run it twice is that the script 
to stitch the images together takes 
about a minute and sometimes, if you 
take an image and then the person 
you’re taking the image of says ‘I don’t 
like that, let’s do it again’, it saves 
cancelling something that’s already 
started. So for logical reasons we 
run it as two separate operations but 
effectively they’re just two commands: 
one command to take the images and 
one command to stitch the images, 
and there’s nothing to stop it all being 
automated. You could put a pressure 


pad in there so that when people stood 
in the middle of the bullet rig it would 
automatically trigger. 

Is the PiFace a crucial component or was 
it just something you wanted to use? 

It was a luxury for us that we had it 
kicking around. It turned out to save us 
time when we were debugging. It’s not 
essential - you can build it without - but 
it made life much easier. We’ve also tried 
it in other configurations, and when you 
put it in other configurations, just being 
able to go through a menu on each Pi 
and then set where it is in the sequence 
is a lot easier if you can actually relate to 
the Pi thatyou’vegot inyour hand, rather 
than having to look at what number it is, 
SSH into it and setafile. 

What configurations have you tried? 

We tried semicircles and we’ve tried 
straight lines, and that way you get the 
effect of the camera panning along as 
opposed to spinning around a point. 
We’ve got future plans, which involve 
taking it into more wild and wacky 
situations. So far we’ve learned from 
the examples we’ve done inside, and 
then as we’ve got the setup faster 
and more automated and got all the 
little tweaks and experiences from it, 
we’re becoming more ambitious with 
it. There are definite plans to mount it 
on impressive things outside and get 
some sports photography going with 
it. There’s one person who actually 
booked us for their wedding after they’d 
seen it - they wanted photographs of 
their guests and it would be different, 
something unusual to capture the 
guests in a 360-degree spin. That’s the 
other nice thing about it - community. 
You put something online and suddenly 
it goes off in a different direction. 


We’ve got future plans, which 
involve taking it into more wild and 
wacky situations 



Andre 

ROjIi-'T 
is an honorary 
research fellow of 
the University of 
Manchester, and the 
creator of PiFace 
Control and Display 
(learn more at 
piface.org.uk) 


Ifyou’re thinking 
of using PiFace 
Control and Display 
inoneofyourown 
projects, check 
out the excellent 
tutorials provided 
by the team over 
at; piface.org.uk/ 
guides 


To see Bullet Pi in 
action, checkout 
this video from 
its first outing at 
the Manchester 
Raspberry Jam in 
2013; bit.ly/1wloP6y 




Software 


72 Supercharge your Pi 

Get the most out of your Raspberry Pi 

76 Create your own digital 
assistant part 1 

Tell your computer what to do 

78 Create your own digital 
assistant part 2 

Continue this project by decoding audio 

80 Create your own digital 
assistant part 3 

Run the commands you're giving your Pi 

82 Run science experiments 
on the Expeyes kit 

Make use of this digital oscilloscope 

86 Monitor CPU temperature 
wHh Dizmo 

Access the Internet ofThings 

90 Forecast the weather wHh 
your Raspberry Pi 

Prepare yourself for the next big storm 

92 Print wirelessly with your 
Raspberry Pi 

Breathe new life into an old printer 

94 Remotely control your 
Raspberry Pi 

Employ your Pi as a media centre 

96 Turn your Pi into a motion 
sensor with SimpleCV 

Implement facial recognition into your Pi 

98 Code a simple synthesiser 

Write a simple synthesiser using Python 


ipercharge yo 
Raspberry h 




Jasper is an open source piatform for developing 
always-on. voice-controlled applications 


ontrol anything 
nth vour voice 


PNIIIPS 


Create a 
digital assistant 


Print documents 
wirelessly 


SOFTWARE 



Supercharge 
your Raspberry Pi 


Get the most out of your Raspberry Pi with these 
performance-enhancing tips and fricks 


Your Raspberry Pi is plugged in. Raspbian is installed on 
the SD card and you are right in the middle of setting up a 
wireless print server or building a robot to collect your mail 
from your doormat. 

But are you truly getting the most from your little 
computer? Do the components you're using maximise the 
potential of your Raspberry Pi or are they holding it baok? 
Perhaps you haven’t explored the full set of options in 
Raspbian, or you’re running the entire OS from SD card, 
somethingthatcan reduce SD card lifespan. 

Various tools and techniques can be employed to 
improve performance, from choosing the right hardware 
to overolocking the CPU. You might even maximise storage 
space on the Raspberry Pi's SD card or all but replace it with a 
secondary device to help improve speed. 

Use these tips and tricks to reconfigure your Raspberry Pi 
setup and optimise software and hardware to ensure you get 
the best performance for your projects. 



Use better storage hardware 

I Your choice of storage media can have an impact on your 
Raspberry Pi’s performance, regardless of the operating system. 
A low capacity SD card with poor error correction, is going to be 
slower than a larger card with greater resilience, so you need to 
find the right balance for your project and shop wisely. 







SUPERCHARGE YOUR RASPBERRY PI 


Choosing the best SD card 

Various standards of SD card are available, with the 
more expensive designed for better error correotion. For the best 
performanee on your Raspberry Pi, choose an SDHC card with a 
high rating. The same advice applies to MicroSD cards, which you 
can use on your Raspberry Pi with an SD card adaptor or directly 
insert into a Raspberry Pi B+. 



Make the most of your storage 

You’ll typically need 1-2GB of storage for your chosen 
Raspberry Pi distro, so any remaining storage on your SD oard will 
be used for updates and data you create or save. 

In Raspbian you can open a command line and run the 
configuration utility to gain more space (only if your SD card’s 
greaterthan2GB): 


I sudo raspi-config 


M Expand the Raspbian partition 

Maximising the partition affords the full capacity of 
your SD card, which will increase the media’s lifespan (there 
is more space to write too, so the same sectors aren’t being 
overwritten as often). 

With raspi-config running, use the arrow keys to select 
expand_rootfs in the menu. Then wait briefly while the 
partition is resized. 


Write data to RAM 

Rather than reading and writing data to your SD card 
- something that will eventually result in a deterioration of 
reliability and performance - you can configure Raspbian to 
write to the system RAM, which will speed things up slightly 
and improve SD card performance. 

This is achieved using fstab (file systems table), a system 
configuration available in most Linuxdistros. 


Above There’s a 
great guide to SD 
cards at eUnux.org/ 
RPi_SD_cards 



Enable fstab in Raspbian 

This is much like creating a RAM disk in Windows and 
is almost as easy to setup. In the command line, enter: 


I sudo nano /etc/fstab 


Add the following line to mount a virtual file system: 

I tmpfs /var/log tmpfs defaults, noatime,nosuid,mode= 
0755,size=100nn 0 0 

Follow this by saving and exiting nano (Ctrl+X), then safely 
restartingthe Pi: 

I sudo shutdown -r now 


Buy rateid 
SD cards 



It’s all tootempting 
to boot up your 
Raspberry Pi with 
an image copied to 
an SD card that you 
just pulled out of 
your DSLR or phone. 
After all, they’re all 
the same, right? 

The chances are 
that your chosen SD 
card wasonethat 
you had lying about 
when you bought 
your Raspberry Pi. 

It might be good 
enough but if you 
wantthe best 
performance, a high- 
rated SDHC card 
with plenty of space 
is recommended. 
Such media is 
inexpensive and can 
be bought online or 
in supermarkets. 
Just make sure 
you’re buying a 
known brand! 





Above Havingyour 
filesystem on a USB 
stick is great for 
backups as well as 
performance boosts 


Picking an 
external 
USB drive 



Speedingupyour 
Raspberry Pi by 
migratingthe root 
filesystem to an 
external USB drive 
is a start, but what 
sort of device should 
you useforthe best 
performance? With 
aUSBthumbdrive 
you can add flash 
storage up to 16 
GB without running 
into any significant 
problems (the 
largerthe drive, the 
greaterthe current 
is required to read/ 
write). Anything 
larger is expensive 
and unnecessary. 

If you’re planningto 
use an external HDD, 
there are no power 
issues as it will 
have its own power 
supply. As ever, your 
choice should suit 
your project. 


Configure fstabforfast performance 

Upon restarting, the virtual file system will be 
mounted and /var/log on the RAM disk. Other directories that 
can be moved to RAM inolude: 

I tmpfs /tmp tmpfs defaults, noatime,nosuid,size=100m 0 0 
I tmpfs /var/tmp tmpfs defaults, noatime,nosuid,size=30 
m 0 0 

I tmpfs /var/log tmpfs defaults, noatime,nosuid,mode=0755, 
size=100m 0 0 

I tmpfs /var/run tmpfs defaults, noatime,nosuid,mode=0755 
,size=2m 0 0 

I tmpfs /var/spool/mqueue tmpfs defaults, noatime,nosuid,m 
ode=0700,gid=12,size=30m 0 0 

Add each to /etc/fstab in nano. 

Move your OS to a HDD 

If you’re concerned about the lifespan of the SD card, 
why not reduce your Raspberry Pi’s reliance on it? Instead of 
using the SD card as a sort of budget SSD, change its role and 
add a HDD or USB stick to run the operating system, leaving the 
SD card for bootstrapping. This can give a marked performance 
boostto the SD card. 

Back uptheSDcard 

Begin by creating a copy of your Raspberry Pi’s SD card. 
Shut down, remove the card and insert it into your desktop 
computer. In the command line, run: 

I sudo dd bs=4M if=/dev/sdb of=~/backup.img 

The path /dev/sdb represents the SD card. Copying should take 
5-10 minutes. When complete, removetheSDcard and connect 
your USB device. 


Copy Raspbian to USB 

Using a blank Ext4-formatted USB thumb drive (or 
external HDD) as the destination drive, enter: 

I sudo dd bs=4M if=~/backup.img of=/dev/sdc 

Leave the backup on your computer, just in case something 
goes wrong. With an SD card and USB storage device sharing 
an identical disk image, it’s time to consider what you’re going 
to do next - create a faster Raspberry Pi. 



Split the Raspbian partitions 

Ideally, the boot partition should remain on the SD card 
while the root filesystem is run from the external HDD or USB 
thumb drive. Usingyour preferred partition manager (Disk Utility 
is in most distros), unmount and delete the root filesystem from 
theSD card, ensuring you have retained the boot partition. After 
removing the SD card, connect your USB device and delete the 
boot partition, taking care to leave the root filesystem intact. 
Then resize the root filesystem on the USB device, making sure 
that 10 MB remains. 








SUPERCHARGE YOUR RASPBERRY PI 



Identify the rootfilesystem 

With this configuration you're going to have the SD card 
and the external USB storage connected, so you need to tell 
the Pi where the root filesystem is. Still on the desktop Linux 
computer with your SD card inserted, run: 


I sudo nano /boot/cmdline.txt 


Find root=/dev/mmcblk0p2 (or similar) and change that to 
read root=/dev/sda2 which is your external USB storage. Save 
and exit. 


B Add other USB devices 

You can now restart your Pi with the storage devices 
attached, but as soon as you connect further USB media 
you'llsuffer problems. Avoid this by installing gdisk: 


I sudo apt-get update 
I sudo apt-get install gdisk 


Then run gdisk: 

I sudo gdisk /dev/sdb 


Enter ? to display the options and select Recovery and 
Transformation options (experts only), followed by Load MBR 
and Build Fresh GPT. Tap ? one last time and select ‘Write 
Table to Disk’ and exit. Remove and replace the USB device 
and run gdisk again. This time enter I and then 1 to display the 
Partition Unique QUID. 

M Make your Pi fast & reliable 

Make a note of the GUID and then switch to the SD 
card. Reopen omdline.txt and change root=/dev/mmcblk0p2 
to root=PARTUUID=XXXXXX, where the numerical string from 
the partition unique GUID should replace the XXXXXX. When 
you’re done, save and exit. You can then start your Raspberry 
Pi. Congratulations, your Raspberry Pi is now faster and more 
reliable to usel 


1 C Boost performance with overclocking 

Need more from your Raspberry Pi? It is possible to 
overclock the computer, although you should be aware of the 
risks inherent with this activity. You should also ensure that 
your Raspberry Pi’s processor is suitably cooled - heatsinks 
for the CPU, Ethernet controller and power regulator can be 
purchased online. 



Overclockyour Raspberry Pi 

IWr Overclocking is available through raspi-config. Launch 
from the command line and arrow down to the overolock 
option. Four further options are available: Modest, Medium, 
High and Turbo. With your ideal clock speed selected, exit 
raspi-config and restart your Raspberry Pi to apply: 


sudo shutdown -r now 


Now you will need to perform tests to see how stable it is 
overolocked. Raspberry Pi founder, Eben Upton, suggests 
running Quake 3 as a good stress test. Should the Pi fail to 
boot, hold Shift to boot without overclooking, run raspi-config 
and select a more modest overclock. 


Run Raspbian without the GUI 

I# Despite these changes, you may find that the GUI 
remains slow. If you find yourself runnings lot of commands in 
bash, the best thing to do is disable launching into X. In raspi- 
config, choose booLbehaviour and select the first (default) 
option to ensure your Pi boots to the command line. Should 
you need the GUI, enter ‘startx’ in Terminal. 


Above Heat sinks 
forthe Pi are widely 
available and usually 
costless than $10 


Overclock 
with a 
heatsink 



OvercLocking 
is potentially 
dangerous to 
any computer 
system, which is 
why it’s great that 
the Raspberry Pi 
developers have 
included the facility 
in their approved 
operating system 
and allowed its use 
underwarranty. If 
you’re usingthis 
feature, heatsinks 
and water cooling 
systems are 
available forthe 
Raspberry Pi to 
ensure you don’t 
baketheCPU and 
RAM when in use. 


SOFTWARE 


Voice 

control 



In this and further 
issues, we will 
Look at the parts 
needed to make your 
own voice control 
software foryour 
projects. If you want 
a virtual assistant, 
one project isthe 
Jasper system 
(JasperproJect. 
github.io).The 
documentation on 
the main website 
has a description of 
hard ware to attach 
to your Raspberry 
Pi and a full set of 
instructions for 
installation and 
configuration. There 
is a set of standard 
modules included to 
allow interaction with 
various services. 
Usethetime, Gmail 
or even the joke 
module, and there 
are alsothird-party 
modules foryou to 
access. There is even 
a developer API and 
documentation to 
help you add your 
own functionality 
to Jasper. 


Right Check outthe 
documentation to 
see what Jasper can 

do: bit.ly/1MCdDh4 


Creole your own 
digital assistant port 1 

Everyone would like to tell their computers 
exactly what to do. Well with Python and a 
Raspberry Pi, now you can 


Everyone who has watched the Iron 
Man movies has probably dreamt of 
having their own artificially intelligent 
computer system to do their every 
bid and call. While Jarvis has massive 
amounts of computing power behind him, 
you can construct the front-end with very 
modest resources. With a Raspberry Pi 
and the Python programming language, 
you can build your own personal digital 
assistant that can be used as a front-end 
to whatever massive superoomputing 
resources that you use in your day-to-day 
life as a playboy, philanthropist genius. 
We will go over the basics that you will 
need to know over the next few pages, so 
that by the end of the series you should 
be able to build your own rudimentary, 
customised agent. 

The first step to interacting with the 
humans around us is to listen for verbal 
commands so that we know what we 
need to process. You have several options 
available to handle this task. To keep 
things simple, we will be dealing only with 
devices that are plugged into one of the 
USB ports. With that stipulation you can 
talk directly with the USB device at the 


lowest level. This might be necessary if 
you are trying to use something that is 
rather unusual to do the listening, but 
you will probably be better off using 
something that is a bit more common. In 
this case you can use the Python module 
PyAudio. PyAudio provides a Python 
wrapper around the low level cross- 
platform library PortAudio. Assumingthat 
you are using something like Raspbianfor 
your distribution, you can easily install the 
required software with the command: 

I sudo apt-get install python- 

pyaudio 

If you need the latest version you can 
always grab and build it from source. 
PyAudio provides functionality to both 
read in audio data from a microphone, 
along with the ability to play audio data 
out to headphones or speakers. So we will 
use it as our main form of interaction with 
the computer. 

The first step is to be able to read 
in some audio commands from the 
humans who happen to be nearby. You 
will need to import the ‘pyaudio’ module 


before you can start interacting with the 
microphone. The way PyAudio works is 
similar to working with files, so it should 
seem familiar to most programmers. 
You start by creating a new PyAudio 
object with the statement p = pyaudio. 
PyAudioO. You can then open an input 
stream with the function p.openC..), with 
several parameters. You can set the data 
format for the recording; in the example 
code we used format=pyaudio.palnt16. 
You can set the rate in Hertz for sampling. 
For example, we are using rate=44100, 
which is the standard 44.1KHz sampling 
rate. You also need to say how big a 
buffer to use for the recording - we 
used frames_per_buffer=1024. Since 
we want to record, you will need to use 
input=true. The last parameter is to 
select the number of channels to record 
on, in this case we will use channels=2. 
Now that the stream has been opened, 
you can start to read from it. You will 
need to read the audio data in using the 
same chunk size that you used when 
you created the stream - it will look like 
stream. read{1 024). You can then simply 
loop and read until you are done. There 
are then two commands to shutdown the 
input stream. You need to call stream. 
stop_stream() and then stream.closeO. If 
you are completely done, you can now call 
p.terminateO to shutdown the connection 
to the audio devices on your Raspberry Pi. 

The next step is to be able to send 
audio output so that Jarvis can talk to 
you as well. For this you can use PyAudio, 
so we won’t have to look at another 
Python module. To make things simple, 
let’s say that you have a WAVE file that 
you want to play. You can use the ‘wave’ 
Python module to load it. Once again, you 
will create a PyAudio object and open a 
stream. The parameter ‘output’ should 
be set to true. The format, the number of 
channels and the rate is all information 
that will be derived from the audio data 
stored in your WAVE file. To actually hear 




# The audio format 
FORMAT pyaudio palntl6 

# The number of channels to record on 
CHANNELS 2 

# The sample rate, 44.1KHz 
RATE - 44100 

# The number of seconds to record for 
RECORD.SECS ^ 5 

# Next, we create a PyAudio object 
p pyaudio PyAudioO 

# We need a stream to record from 

stream p open (format FORMAT, channels CHANNELS, 

rate RATE, input TRUE, frames_per_buffer CHUNK) 

# We can now record into a temporary buffer 
frames [] 

for i in range(0, int(RATE CHUNK * RECORD_SECS)) : 
data stream read (CHUNK) 
frames append (data) 

# We can now shut everything down 
stream. stop_stream() 

stream close () 
p terminateO 

# If we want to play a wave file, we will need the wave module 
import wave 

# We can open it, give a filename 
wf wave open(“filename wav”, “rb”) 

# We need a new PyAudio object 
p pyaudio PyAudioO 

# We will open a stream, using the settings from the wave file 
stream = p open(format :p.get_format_from_width(wf getsampwidthO) , 

channels=wf , getnchannelsO , rate^wf . getf ramerate() , 
output=T rue) 

# We can now read from the file and play it out 
data wf readframes (CHUNK) 

while data ‘ : 

stream write(data) 

data wf readframes (CHUNK) 

# Don’t forget to shut everything down again 
stream stop_stream() 

stream close () 
p terminateO 


the audio you can simply loop through, 
reading one chunk of data from the WAVE 
file at a time and immediately writing out 
to the PyAudio stream. Once you’re done 
you can stop the stream and close it, as 
you did above. 

In both of the above cases, the 
functions block when you call them 
until they have completed. What are 
the options if you want still be able 
to do processing while you are either 
recording audio or outputting audio? 
There are non-blocking versions that 
take a callback function as an extra 
parameter called stream_callback. This 
callback function takes four parameters, 
named in_data, frame_count, time_info, 
and status. The in_data parameter will 
contain the recorded audio if input is 
true. The callback function needs to 
return a tuple with the values out_data 
and flag. Out_data contains the data to 
be outputted if output is true in the call 
to the function open. If the input is true 
instead, then out_data should be equal to 
None. The flag can be any of paContinue, 
paComplete or paAbort, with obvious 
meanings. One thing to be aware of is that 
you cannot call, read or write functions 
when you wish to use a callback function. 
Once the stream is opened, you simply 
call the function stream.start_stream{). 
This starts a separate thread to handle 
this stream processing. You can use 
stream. is_active() to check on the current 
status. Once the stream processing is 
done, you can call stream.stop_stream() 
to stop the secondary thread. 

Now that we have covered how to get 
audio information into and out of your 
Raspberry Pi, you can start by adding this 
functionality to your next project. In the 
next step, we will look at how to convert 
this audio information into something 
usable by the computer by using voice 
recognition modules. We will also look at 
the different ways to turn text into audio 
output usingTTS modules. 


SOFTWARE 


Offload 

tasks 


You can offload 
the audio data 
processingto 
Google, accessing 
the API directly over 
HTTP by posting 
youraudiodatato 
the appropriate 
URL First install 
the Python module 
SpeechRecognition: 

• pip install 
SpeechRecognition 

Now create an 
instance of the 
Recognizer object. 

A Helper object, 
called WavFile, will 
take an audio file 
and prepare it for 
use by the Google 
API. Then process 
it with the recordO 
function and hand 
this processed audio 
into the function 
recognizeQ. When 
it returns, you will 
get a list of pairs of 
possible texts, along 
with a percentage 
confidence levelfor 
each possible text 
decoding. Be aware 
thatthis module uses 
an unofficial API key 
to do its decoding, 
so for anything more 
than small personal 
testingyou should 
request yourown 
API key. 


Right CMUSphinx 
is used in cross- 
platform, open 
source projects like 
ILA.the Intelligent 
LearningAssistant 


Digital assistant, part 2: 
speech recognition 

In this second instalment, learn how to decode 
your audio and figure out what commands are 
being given by the humans araund you 


Previously we looked at how we could 
have our Raspberry Pis listen to the 
world around them. This is the first 
step in building our own version of the 
J.A.R.V.I.S system made famous in the 
Iron Man movies. The next step is to try 
and make sense of what we may have 
just heard. In general, this is called 
speech recognition and it is a very large 
and active area of research. Every major 
mobile phone operating system has 
applications trying to take advantage 
of this mode of human interaction. 
There are also several different Python 
modules available that can do this 
speech-to-text (STT) translation step. In 
this second article, we will look at using 
Pocket Sphinx to do all the heavy lifting. 
Sphinx was developed by Carnegie 
Mellon University and is licensed under 
a BSD licence, so you are free to add 
any extra functionality that you may 
need for specific tasks. Because of the 
activity in this field, it is well worth your 
time to keep track of all the updates and 
performance improvements. 

While you can download the source 
code for all of these modules and build it 


all from scratch, we are going to assume 
that you are using one of the Debian- 
based distributions, like Raspbian. For 
these you can simply use: 

I sudo apt-get install python- 
pocketsphinx 

...to get all of the required files for the 
engine. You will also need audio model 
files and language model files in order 
to get a translation in you language of 
choice. To get the files needed for English, 
you can install the packages: 

I sudo apt-get install pocketsphinx- 
hmm-wsjl pocketsphinx-lm-wsj 

You may need to go outside the regular 
package management system if you want 
to process other languages. Then you 
can simply start writing and using your 
code straight away. To start using these 
modules, you will need to import both 
pocketsphinx and sphinxbase with: 

import pocketphinx as ps 
import sphinxbase 


These modules are actually Python 
wrappers around the C code that 
handles the actual computational work 
of translating sounds to text. The most 
basic workflow involves instantiating a 
Decoder object from the pocketsphinx 
module. The Decoder object takes several 
input parameters to define the language 
files it is allowed to use. These include 
‘hmm’, ‘Im’ and 'diet'. If you use the above 
packages used to handle English, then 
the files you need will be in the directories 
/usr/share/pocketsphinx/model/hmm/ 
wsjl and /usr/share/pocketsphinx/ 
model/lm/wsj. If you don’t set these 
parameters, then it tries to use sensible 
defaults which usually work fine for 
English language speech. This newly 
created Decoder object can now be given 
WAV files with data to process. If you 
remember that previously, we saved the 
recorded speech as a WAV file. In order 
to have this audio recorded in the correct 
format, you will want to ed it the code from 
the first tutorial and ensure that you are 
recording in mono (using one channel, for 
example), and recording at 16kHz with 16- 
bit quality. To read it properly you can use 
a file object and load it as a binary file with 
read permissions. WAV files have a small 
piece of header data at the beginning of 
the file that you need to jump over. This 
is done by using the seek function to 
jump over the first 44 bytes. Now that 
the file pointer is in the correct position, 
you can hand the file object in to the 
Decoder object’s decode_raw() function. 
It will then go off and do a bunch of data 
crunching to try and figure what was 
said. To get the results, you would use the 
get_hyp() function call. You get a list with 
three elements from this function: a string 
containing the best guess at the spoken 
text, a string containing the utterance ID 
and a number containing the score for 
this guess. 

So far, we’ve looked at how to use the 
generic language and audio models 
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for a particular language. But Pocket 
Sphinx is a research-level language 
system, so it has tools available to 
enable you to build your own models. 
In this way, you can train your code to 
understand your particular voice with 
all of its peculiarities and accents. This 
is a long process, so most people will 
not be interested in doing something so 
intensive. However, if you are interested, 
there is information available at the main 
website (cmusphinx.sourceforge.net). 
You can also define your own models and 
grammars to tell pocketsphinx how to 
interpret the audio that it is processing. 
Once again, effectively carrying out 
these tasks will require more in depth 
reading on your part. 

If you want to process audio more 
directly, you can tell Pocket Sphinx to 
start processing with the function start_ 
utt{). You can then start reading audio 
from your microphone. You will want to 
read in appropriate sized blocks of data 
before handing it in to pocketsphinx 
- specifically to the function process_ 
raw() - and you will still need to use the 
function get_hyp() to actually get the 
translated text. Also, because your code 
can’t know when someone has finished 
a complete utterance, you will need 
to do this from within a loop. On each 
pass of the loop, read another chunk 
of audio and feed it into pocketsphinx. 
You then need to call get_hyp{) again to 
see if you can get anything intelligible 
from the data. When you are done doing 
this real-time processing, you can use 
the function end_utt{). 

So far, we have covered how to record 
your speech and howto turn that speech 
into text. In the next tutorial, you will 
learn how to take that translated speech 
and actually take actions based on 
how the system has been configured. 
But even with only these two steps, 
you could build yourself a nifty little 
d ictaphone or vocal note-taki ng system . 


Full code listing 

# You first need to import the required modules 
import pocketsphinx as ps 

import sphinxbase 

# Next, you need to create a Decoder object 
hmmd ^ Vusr/share/pocketsphinx/model/hmm/wsjl’ 

Imd = ‘ /usr/share/pocketsphinx/lm/ws j /wlistSo . 3e-7 . vp . tg . Im . DMP ’ 
dictd ‘ /usr/share/pocketsphinx/lm/ws j/wlist5o. die’ 

d = ps. Decoder (hmm= hmmd, lm=lmd, dict-dietd) 

# You need to jump over the header information in your WAV file 
wavFile = (‘my_file.wav’, ‘rb’) 

wavFile.seek(44) 

# Now you can decode the audio 
d . decode_raw(wavFile) 
results d.get_hyp() 


# The most likely guess is the first one 

decoded_speech = results [0] 

print “I said “, decoded_speech[0], “ with 


a confidence of ”, decoded_speech[ ] 


# To do live decoding, 
import pyaudio 
p “ pyaudio. PyAudioO 


you need the PyAudio module 


# You can now open an input stream 

in_stream p.open(format pyaudio. palntl6, channels=l, rate=16000, 
input=T rue , f rames_per_buf fer=1024) 
in_stream. start_stream() 

# Now you can start decoding 
d.start_utt() 

while True: 

buf = in_stream. read(1024) 
d.process_raw(buf, False, False) 
results d.get_hyp() 

# Here you would do something based on the decoded speech 

# When you are done, you can shut everything down 
break 

d.end_utt() 


^A_software 


Digital assistant, part 3: 
run other programs 

This third and final article will cover how to 
actually run the commands you are giving to 
your Raspberry Pi 


Social 

media 


You may want your 
system to check 
your social media 
accounts on the 
internet. There are 
several Python 
modules available 
to handle this. Let’s 
say that you want to 
be able to check your 
Facebook account. 
Install the following 
Python module: 

sudo apt-get 
install python- 
facebook 

You can then use 
import facebookto 
get access to the 
FacebookAPi. If 
you’re a Twitter user, 
install the python- 
twitter Debian 
package to use the 
Twitter API. Email 
is easier as long as 
your email provider 
offers iMAPor POP 
access. You can then 
import emails and 
getvoice controlto 
read unread emails 
outtoyou. Forthe 
Google fans, Google 
has a Python module 
that provides access 
totheAPIsfor 
almost everything 
available; work with 
your calendar, email 
orfitnessdata. 


This is the last in our trilogy of articles 
to help you build your own voice control 
system. The first article looked at how 
to listen for incoming commands. This 
involved listening on a USB device and 
also outputting audio feedback to a 
user. The second article looked at how to 
interpret those commands. This involved 
using speech recognition libraries to 
translate the recorded audio into text that 
can be processed. This time, we will look 
at how to actually run the commands that 
were given. We will look at a few different 
options to execute tasks and get work 
done based on the interpreted speech. 

If you have put together a system 
based on the suggestions from the first 
two articles, you should have a string 
containing the text that was spoken to 
your Raspberry Pi. But, you need to figure 
out what command this maps to. One 
method is to do a search for keywords. 


If you have a list of keywords available, 
you can loop through them and search 
the heard stri ng to see if any one of those 
keywords exist within it as a substring. 
Then you can execute the associated task 
with that keyword. However, this method 
will only find the first match. What 
happens if your user accidentally includes 
a keyword in their spoken command 
before the actual command word? This 
is the auditory equivalent to having fat 
fingers and mistyping a command on the 
keyboard. Being able to deal with these 


errors gracefully is an ongoing area of 
research. Maybe you can create a new 
algorithm to handle these situations? 

Let’s say that you have a series of 
Python scripts that contain the various 
tasks you want your system to be able 
to tackle. You need a way to have your 
system be able to run these scripts when 
called upon. The most direct way to run 
a script is to use execfile. Say you have 
a script called dojask.py that contains 
Python code you want to run when a 
command is given; you can run it with: 

I execfile(“do_task.py”) 

Using this form, you can add command 
line options to the string being handed 
in. This will look in the current directory 
for the script of that file name and run it 
in the current execution context of your 
main program. If you need to rerun this 


code multiple times, call execfile each 
time you do. If you don’t need the script 
to run within the same context, use the 
subprocess module. Import it with: 

import subprocess 

You can then execute the script like so: 

subprocess. call(“do_task.py”) 

This will fork off a subprocess of the 
main Python interpreter and run the 


script there. If your script needs to 
interact with the main program, this 
is probably not the method that you 
should use. Collecting output from a 
call to do_task.py with subprocess 
isn’t straightforward, so another way 
of achieving the same thing is to use 
the import statement. It also runs the 
code in your script at the point the 
import statement is called. If your 
script only contains executable Python 
statements, these get run at the point of 
importation. In order to rerun this code, 
you need to use the reload command. 
The reload command doesn’t exist in 
version three - so if you’re using that 
particular Python version, a better 
option is to encapsulate the code 
contained in the script within afunction. 
You can then import the script at the 
beginning of your main program and 
simply call the relevant function at 
the correct time. This is a much more 
Pythonic method to use. If you have the 
following contents for do_task.py: 

, f do_func(): 
do_taskl() 
do_task2() 

You can then use it with the following 
code within your main program: 

import do_task 

do_task.do_func() 


An even more Pythonic method is to use 
classes and objects. You can write a script 
that defines a class that contains methods 
foryou to call when you need it. 

What are the options if you want 
to do something that isn’t achievable 
with a Python script? In these cases, 
you need to be able to run arbitrary 
programs on the host system. The host 


A more Pythonic method is to 
use classes and objects. You 
can write a script that defines 
a class that contains methods 
foryou to call when you need it 



system in this case is your Raspberry 
Pi. As a toy example, let us say you 
need to download some emails using 
the Fetchmail program. You can do 
this in a couple of different ways. The 
older method is to use the os.systemQ 
command where you hand in a string. In 
our example, this would look something 
like the following: 


Full code listing 

do_task.py 

" do_func(): 
print “Hello World” 

main_program.py 


os.system(“/usr/bin/fetchnnail”) 

You need to explicitly use os.waitQ to be 
told exactly when the task has finished. 
This method is now being replaced by 
the newer subprocess module. It gives 
you more control over how the task gets 
run and how you can interaot with it. A 
simpleequivalenttotheaboveoommand 
would look like this: 

subprocess. call(“/usr/bin/ 
fetchmail”) 

It waits until the called program has 
finished and returns the return code to 
your main Python process. But what if 
your external program needs to feed 
in results to your main program? In 
this case, you can use the command: 
subprocess.check_output(). This is 
essentially the same as subprocess. 
callO, except when it finishes, anything 
written out by the external program to 
stdout gets handed in as a string object. 
If you also need information written out 
on stderr, you can add the parameter 
stderr=subprocess.STDOUT to your call 
to subprocess.check_output. 

After reading these three articles, you 
should have enough of the bare bones 
to be able to build your own version of 
the J.A.R.V.I.S system. You will be able 
to fine-tune it to do basically anything 
that you command it to do. So go forth 
and order your machines around, and 
have them actually listen to what you are 
saying for once. 


# You can import your own module to do tasks and commands 
import do_task 

# You can then go ahead and run any included functions 
do_task . do_func 0 

# You can run system programs directly 
import os 

# The exit code from your program is in the variable returncode 
returncode os.system(“/usr/bin/fetchmail”) 

# The subprocess module is a better choice 
import subprocess 

# You can duplicate the above with 

returncode = subprocess. call(“/usr/bin/fetchmail”) 

# If you want to get the output, too, you can use 
returned_data subprocess. check_output(‘7usr/bin/fetchmail”) 



Left The Jasper 
project has some 
great documentation 
that might help guide 
you further in terms 
of hardware and 
software choices 



Run science experiments 
on the ExpEYK kit 

ExpEYES is a cheap digital oscilloscope with a signal generator and 
other features, making it the ultimate tool for elecfronics 


ExpEYES is a relatively unheard of but very impressive 
hardware and software platform for science and 
electronics experimentation, as well as a useful electronic 
probing tool for makers and professionals alike. It is also 
open source on both the hardware and software sides, which 
makes it affordable and versatile. 

ExpEYES is billed as a science and experimentation kit 
but really it is much more than that - it is a fully-functioning 
four-channel digital oscilloscope with an impressive 
array of features. ExpEYES ships with a wealth of online 
documentation in a variety of formats (graphics, user 
guides, web content), including upwards of 50 suggested 
experiments, and the kit itself contains all of the hardware 
required to play with the interesting science of electronics 
contained within the guide material. 

The aim is to enable the learning of what can be complex 
concepts of electronics in an easy and affordable way, 
without getting bogged down in the arcane details. Paired 
with our favourite little single-board computer, the Raspberry 
Pi, you have an extremely powerful and affordable device. 



Get the parts 

ExpEYES is available to purchase from a variety of online 
vendors, inoluding CPC (http://cpc.farnell.com), for around £50. 
It is possible to get the kits slightly cheaper from India or China 
(see bit.ly/1H38EFC for other vendors worldwide), however it’s 
likely to end up costing more due to higher shipping rates as well 
as potential import fees and duties. 
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Left The kit itself 
is highly portable 
and great fortaking 
down to Jams and 
backspaces 


Open it up 

The ExpEYES kit contains everything you need to get 
underway, with over 50 documented experiments from the 
ExpEYES website. The only other item that may come in handy 
is a breadboard. You will also need a Raspberry Pi or other 
computer with a USB port in order to run the digital oscilloscope 
software and con neot to ExpEYES. 



What’s inside? 

As you may have guessed, the ExpEYES kit includes 
the main ExpEYES USB digital oscilloscope, but it also contains 
a wide range of other hardware including a DC motor, magnets, 
LEDs, coils, piezoelectric discs, wiring, a small screwdriver for 
opening the screw terminals and more. You also get a live CD 
which contains all the ExpEYES software and documentation 
ready to go on a bootable disc. 


M What can it do? 

The chip at the heart of ExpEYES is an AVR ATmegalB 
MCU (microcontroller unit), running at 8 MHz coupled to a USB 
interface 1C (FT232RL). These are low-cost but provide good 
value for money. As we have already mentioned, ExpEYES is 
therefore capable of acting as a four-channel oscilloscope but 
also has a built-in signal generator, 12-bit analogue resolution, 
microsecond timing resolution and a 250 kHz sampling 
frequency. At this price point, that’s an impressive set of features 
and certainly accurate enough for anything that is not mission 
critical (like learning, hobby projects, quick readings and so on). 


It pays dividends to make sure that 
your operating system is updated to 
the latest stable version, as this can 
save you a lot of hassle 
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UsingtheliveCD 

Perhaps the easiest way to get up and running with 
ExpEYES (if you have a computer with a CD drive) is to use the 
live CD which is included in the ExpEYES kit. Making sure that 
you are booting into the live CD from your BIOS boot menu, you 
should then be greeted with a Linux-based desktop. Plug in your 
ExpEYES by USB and you can open the software from the menu 
by going to Applications>Science>ExpEYES-Junior. Alternatively, 
you can run itfromaterminal window using: 

I sudo python /usr/share/expeyes/eyes-junior/croplus.py 

Update your Raspberry Pi 

As with almost every project you undertake on the 
Raspberry Pi, it pays dividends to make sure that your operating 
system is updated to the latest stable version, as this can save 
you a lot of hassle further down the line. To do this, open an 
LXTerminal session and then type sudo apt-get update, followed 
by sudo apt-get upgrade -y, and then wait patiently for the 
upgrade process to complete. 


Other 

supported 

platforms 


The ExpEYES 
software is mainly 
written in Python. 
This means thatthe 
core software to 
run your ExpEYES 
device is quite 
platform-agnostic - 
if the device can run 
a Python interpreter 
and has a Python 
module enabling it 
to accessthe serial 
port then it will work 
with ExpEYES. Ifyou 
visitthe ExpEYES 
website, there is a 
pagethat explains 
howto installthe 
software on Linux 
and Windows - 
www.expeyes. 
in/software- 
installation. In 
addition, there isa 
native Android app 
which will enable 
your ExpEYES 
to work with any 
Android device that 
has USB OTG (on the 
go) capability. 






SOFTWARE 


ExpEYES 
& PHOENIX 


ExpEYES was 
developed byAjith 
Kumar and his 
team as part of the 
PHOENIX (Physics 
with Homemade 
Equipment 
and Innovative 
Experiments) 
project, which was 
started in 2005 as a 
part of the outreach 
program of the 
Inter-University 
Accelerator Centre 
(lUAC)inNew Delhi, 
India. Its 
objectives are 
developing 
affordable 
laboratory 
equipment and 
training teachers to 
use itintheir 
lesson plans. 



Install the software 

\Mm Due to efforts of community member Georges 
Khaznadar, there are DEB packages available for the ExpEYES 
software that should work perfectly on Debian, Ubuntu, Linux 
Mint and, of course, Raspbian. These are also included in the 
official Raspbian repositories, so all you need to do to install 
the ExpEYES software is to open an LXTerminal session on the 
Raspberry Pi and then run the following commands: 


I sudo apt-get update 
] sudo apt-get install expeyes 


Install dependencies 

ExpEYES has a number of dependencies that are 
required for it to run under Linux, as well as a number of other 
recommended libraries. During the installation undertaken 
in Step 7, the dependencies should be installed by default. 
However, to avoid any problems later, you can run the following 
command in order to make sure that they are all installed: 


■ sudo apt-get install python python-expeyes python- 
imaging-tk python-tk grace tix python-numpy python- 
scipy python-pygrace 



AA Overclockyour Raspberry Pi (optional) 

The ExpEYES software will run fine on a Raspberry Pi 
with default settings, however it can be slow to respond if you 
are using a Model A, B or B+. We recommend using a Model 2B, 
but if you don’t have one, overclocking your Pi would be advisable 
(you can overclockyour 2B as well if you want itto run a bit faster). 
Open an LXTerminal session and type sudo raspi-config. in the 
menu, select the option 7 Overclock’. Click OK on the following 
screen and then select Turbo. Click OK and you should see some 
code run. Once this completes, press OK again and then you are 
brought back to the main raspi-config window. Select Finish in 
the bottom right and Yes to reboot your Raspberry Pi. 



^A Overclocking continued 

Overclock can sometimes cause instability on your 
Raspberry Pi or an inability to boot at all. If this happens you can 
press and hold the Shift key on your keyboard once you reach the 
above splash screen to boot into recovery mode. You can then 
redo Step 7 at a lower overclook setting and repeat until you find 
the highest stable setting. 


Resistance of the human body 

I I An interesting experiment for your first time using an 
oscilloscope itto measure the resistance of the human body over 
time. This is easy to accomplish with just three bits of wire and a 
resistor (200 kOhm). On the ExpEYES, connect a wire between 
A1 and PVS, connect the resistor between A2 and ground, and 
connect an open-ended wire out of both PVS and A2. Plug in your 
ExpEYES and open the control panel, then drag A1 to 0H1 and 
A2toCH2, and set PVS to 4 volts. You can then pick up one of the 
open-ended wires in each hand and watch the response on the 
ExpEYES control panel. 


^A Run the maths 

From the output plot, you should find that the input on 
CHI is coming out at 3.999 volts (which is great because we set 
it to be 4!). The voltage on A2 (CH2) is showing as 0.9 volts for 
us, which implies that the voltage across the unknown resistor 
value (your body) is 4 - 0.9 = 3.1 volts. Using Ohm’s law (V=IR), 
we can then calculate the current (i) across the known resistor 
value: voltage -t resistance = 0.9 -t 200,000 = 0.0000045 amps 
= 4.5 uA (micro amps). Using this value we can then calculate 
the resistance of the body using the same Ohm’s law equation in 
reverse: voltage -t current = 3.1 e 0.0000045 = 688889 ohms = 
689 kO. This is a surpisingly high value, however the resistance 
of the human body depends hugely on how dry your skin is and 
a large number of other factors (body resistance is usually in the 
range of 1 ,000 to 1 00,000 ohms). 


B Use the Python library 

The ExpEYES team have built a custom Python library 
for the device. This is slightly harder to use than the GUi and 
not as pretty, but it enables a lot more versatility as well as the 
capability to use ExpEYES functionality within your Python 
scripts, if you have followed the installation instructions above, 
all you need to do is import the Python module and then initialise 
a connection to the Exp EYES using: 


I import expeyes. eyesj 
I p=expeyes. eyesj. open() 
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Above There’s a great range of 
experiements for you to try inside 
the ExpEYES documentation over 

at: bit.ly/1E7hdYy 


M The Python library (continued) 

Now we will plot a sine wave using the ExpEYES and 
PyLablibraries. On the device, connect 0D1 to INI and SINE to A1 
with some wire. Run the following code and you should see that a 
sign wave has been plotted. 


A (digital storage oscilloscope is 
a useful tool in any engineer or 
hacker’s toolbox, as it enables you 
to get insights into your projects that 
aren’t possible with visual checks 


1C Further experiments 

This tutorial has shown you just a single example of 
the documented ExpEYES experiments available at http:// 
expeyes.in. There is a wide variety of different techniques 
and phenomena explored in those experiments, so it is highly 
recommended to get your hands on an ExpEYES kit and work 
through them. Running through those examples as a beginner 
will give you a much deeper understanding of electronics. 


I import expeyes.eyesj 
I from pylab import * 

I p=expeyes.eyesj.open() 

I p.set_state(10,l) 

I print p.set_voltage(2.5) 

I ion() 

I t,v = p. capture (1,300,100) 
I (plot t,v) 


The verdict 

1^# A digital storage oscilloscope (plus extras) is a useful 
tool in any engineer or haoker's toolbox, as it enables you to get 
insights into your projects that aren't possible with just visual 
checks or using a multimeter. Whilst no £50 oscilloscope will 
compare to expensive professional units, this is a great entry- 
level product as well as a versatile, portable USB device with 
multiplatform support for when you just can’t be lugging around 
a 1 0 kg, £1 000+ scope. 




GO 

SOFTWARE 


AAonHorQ^ 
temperature with Dizmo 

Turn your Raspberry Pi into an internet of Things with this CPU 
temperature gauge tutorial 



The Raspberry Pi is an exciting 
prospect for people interested in an 
Internet of Things - size, power and 
flexibility make it perfect for powering 
any Internet-connected device 
around the home or office. Setting up 
a Raspberry Pi to be the brain of an loT 
network isn't exactly a case of selecting 
the right software in Raspbian, though; 
there's a lot of custom work you need to 
do to get one going. 

This is where Dizmo comes in, 
enabling you to control loT objects 
using an online API that you can then 
access remotely. To show you how it 
works, we're going to have it track the 
Raspberry Pi’s core temperature. In this 
tutorial we are going to work entirely 
over SSH, but you can easily do this 
straight on the Pi - the benefit of SSH 
though is that for a real loT, it will be 
easier to maintain remotely. 



Dial into your Pi 

I Make sure your Raspberry Pi can connect to your 
network, either via Wi-Fi or ethernet cable, and find out the 
IP address by using ifconfig. Use this IP to dial into the Pi from 
another system with: 


I $ ssh pi@[IP address] 


Above Dizmo is 
designed to be 
a multi-touch 
interface 





MONITOR CPU TEMPERATURE WITH DIZMO 


d\zmr-j 



Downloads 


Linux 

TAR xRA |37b<l. Dcbldnl 
Verston 1 0f2 Build 746 
Ilixuluil 

ij .rv.nimi" 40 MB 

TAR x64 IB'lbit. OeblanI 
V«lWOn I.0r2 Build 746 
IFuiriusi 

. -v/'-'nm* 40 MB 


Get dizmo 


' -I. t ; . i" . 

Downlood*( 


TAR x66 |32bit. UbuntuI 
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TAR x64 |64bft. Ubunlul 
Version 1 0r2 Bu4d M6 
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Left Builds are 
available for various 
distrosonthe 
Download page, and 
you can also check 
the pricing plans 


Install dizmoSpace 

If you haven’t already, head to www.dizmo.com, grab 
dizmoSpace and install it to the system you plan for it to work 
with. All you need to do is download the zip and unpack it, then 
click the Dizmo icon or run it from the terminal. 



Launch issues? 

If Dizmo is complaining about libraries when you try 
to run it, you'll need to install some extra software. Open the 
terminal on the PC you're working from and install the extra 
software with the following: 


$ sudo apt-get install libavahi-compat-libdnssd-dev 
$ sudo apt-get install libavahi-client-dev 


M Download node.js 

Now, we need to grab the latest version of node.js for the 
Raspberry Pi. Back in the SSH connection to your Raspberry Pi, 
use the following: 

I $ sudo wget http://node-arnn.herokuapp.com/ 
node_latest_armhf.deb 
I $ sudo dpkg -i node_latest_armhf.deb 


A Dizmo widget is a HTML file, 
packaging resources together to 
create an interface or graphic. Our 
HTML file uses jOuery 



^1? Add framework 

Use node -vto check if it’s installed correctly - it should 
spit out a version number for you. Once that’s done, install 
expresses, which will be our web application framework: 


1 $ sudo npm install -g express 

$ sudo npm install -g express-generator 


Install framework 

We’ll create the folder www in var and create a symlink 
for everything to run. Do this by moving to var, creating www and 
making the symlink with: 


I $ cd /var 

i $ sudo mkdir www 

$ cd WWW 

I $ sudo In -s /usr/local/lib/node_modules/ 
/node_modules 
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Above As it’s 
multi-touch, Dizmo 
is perfect for 
interactive table 
displays in meetings 

Internet 
of Things 


It’s notavery 
descriptive term, 
butthe Internet 
of Things can be 
almost anything. Any 
item that is or can 
be connected tothe 
internet or networks, 
such as modern 
automated lights, 
can be connected 
upto Dizmo and the 
Raspberry Pi. 

Dizmo space walk 

Enjoy some pre- 
installed projects 
to see exactly what 
Dizmo can do 

PiGauge Create 
aoustomapp 
to monitorthe 
tern peratu re of you r 
Raspberry Pi, and 
then go even further 

Browser Create 
an entire custom 
display using 
a variety of 
information that 
can connect to and 
through the Pi 



Package file 

\Jw First, create the file package.json with sudo 
package, json, then enter: 


{ 

“name”: “ServeSysinfo”, 

“version”: “ 0 . 0 . 1 ”, 

“dependencies”: {“express”: “4.x”} 

} 




App node 

Now, create a file called app.js and enter the following: 


var express = require(‘express’); 
var app = express(); 

app.use(express.static( dirname + ‘/public’)); 

app.listen(3000, function(){ 
console. log(‘listening on *.3000’); 

}); 



Start node.js 

You can now start the node server by typing in: 


I $ node app.js 


It will say it's listening on *.3000. Start up a new terminal, ssh in, 
and create the folder /public with mkdir /public to save all of the 
CPU detain. 



CPU information 

l\/ We are going to use the vcgencmd command to get the 
CPU information from the Raspberry Pi. We will write a script that 
will do this and then write the info to sysinfo.json. Download the 
file grabsysinfo.sh from FileSiloand put itin/usr/local/bin. 

Makeacronjob 

I I We will make it so that the temperature is updated every 
ten minutes. You can make it update much faster if you want, but 
have a play around with that. Open up cron with sudo crontab 
-e and add this at the end: 


*/10 * * * * /usr/local/bin/grabsysinfo.sh 
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With these building blocks, you can 
now start doing more interesting loT 
things - controlling the GPIO ports, 
getting more information 


start creating the widget 

It is time to actually start building the widget. First of all, 
create a folder on your local machine called Gauge and cd to it. 
Now you need to download the first file called info.plist into here 
by using the following: 


Style guide 


Now we’ll add the CSS style sheet for the Dizmo widget. 
As usual, this styles up the display on the page that will become 
our widget. Download it with: 


Above We’ve gone 
for a simple CPU 
temperature gauge, 
butthe possibilities 
really are end less 


$ wget x/info.plist 



index file 

A Dizmo widget is basically a HTML file, packaging 
resources together to create an interface or graphic. Here, we 
have the main HTML file that uses jQuery, which helps display 
thetemperature. Still in the Gauge folder, download it with: 

I $ wget x/index.html 


wget x/style.css 

Final application 

The final step is to create the application.js file, which will 
call the temperature from the Raspberry Pi using Ajax. You can 
download it using: 

I wget x/application.js 

Change the IP add ress to the one on you r Pi. 

Once that’s done, you can test out the widget - compress the 
Gauge folder to a .zip and then change the .zip to a .dzm. Launch 
dizmoSpace and drag the dzm file onto it for it to start. 

Get coding 

With these building blocks, you can now start doing more 
interesting loT things - controlling the GPIO ports, getting more 
information, having it connect to other objects to control them 
as well. Check out the Dizmo website for more details on projects 
thatyoucando. 







SOFTWARE 


Forecast the weather 
with your Raspberry Pi 

With Python and a Raspberry Pi, you can keep an eye on 
the weather and be prepared for the next big storm 


Why 

Python? 



It’s the official 
language of the 
Raspberry Pi. 


Read the docs at 

python.org/doc 


Being someone who lives on the 
east coast of Canada, the weather is 
something that is consistently a topic 
of conversation. The common wisdom 
is that if you don’t like the weather, just 
wait five minutes and it will change 
to something else. While people have 
used Raspberry Pis to create lots of 
applications like Twitter tickers, I thought 
that here we could look at how to write 
upaweathertickerin Python. 

There are many different services 
available that provide weather data 
through a number of different APIs. 
Some can be accessed directly 
through a URL, while others are a bit 
more complicated. Luckily, for the 
more oomplioated options there are 
wrappers written to make the data 
collection easier. We will look at several 


personal use. If you need more than 
this, you can purchase an API key that 
covers more usage. Interacting with 
Weather Underground involves sending 
a request as an HTTP URL and receiving 
either a JSON orXMLfile back. 

In the sample code, we pull back the 
data as JSON. The first thing you will 
need is your location identifier. You can 
request a location identifier by either 
latitude and longitude or by geolocating 
your current IP address. You can even 
do a search by place name. Once you 
have this, you can go ahead and start 
to make data requests. You can import 
the urllib2 and json modules to make 
the request and parse the output. 
Let’s say you wanted to get the current 
conditions at Cedar Rapids. You could 
do this with the following Python code: 


hourly forecasts and tide forecasts. 
There is also historical information, in 
case you need historical data for some 
other project. 

The next service we will look at is that 
provided by forecast.io. Forecast.io 
aggregates weather data from several 
different sources around the world. It 
parses through all of these data sources 
and provides current weather conditions 
and a forecast for your location through 
an API over HTTP. The returned data can 
be a bit messy, so there are wrappers for 
many different environments, including 
Python. This wrapper is available on 
GitHub from Ze’ev Gilovitz (https:// 
github.com/ZeevG/python-forecast.io). 
While you can download and install from 
source, you should be able to install it 
using pip with: 


[ There are many different 
services that provide weather 
data through a number of APIs 


services and see how to pull data 
from a number of them. From there, 
you can decide how best to display all 
of this information. The first service 
we will look at is the one provided by 
Weather Underground {http://www. 
wunderground.com). 

This service uses weather 
information collected by individuals 
from around the world, using data 
from personal weather stations. As 
with most services, you will need to 
get an API key in order to pull down the 
weather data for your ticker. You can 
purchase a developer key for free, as 
long as you don’t download data more 
than 500 times per day or 10 times per 
minute. This should be adequate for 


f urllib2.urlopen(‘http://api. 
wunderground.com/api/YOUR_KEY/ 
geolookup/conditions/q/IA/Cedar_ 
Rapids.json’) 

This will return a JSON file. You can now 
load this data and parse it with 

json_str = f.readO 
json_parsed = json.loads(json_str) 

The json_parsed variable will now 
contain all of the available current 
conditions, such as temperature or 
precipitation. There are many other 
data features provided by the Weather 
Underground, including weather alerts, 
a three-day forecast, a ten-day forecast. 


I pip install python-forecastio 

As with Weather Underground, you will 
need to go to https://forecast.io and 
get an API key in order to make requests. 
And, as with Weather Underground, 
this API key is free. Once you import the 
module, you can call Toad_forecast()' 
to get the data. The object storing the 
returned results contains everything 
available and has several access 
functions. For example, you can get the 
hourly forecast with the object function 
‘hourlyO’. These access functions have 
functions within them to access parts of 
the sub-data. For example, you can look 
at the hourly temperature with: 

byhour forecast. hourlyO 
for hourlyData in byhour.data: 
print hourlyData. temperature 

In most instances, the information 
available through the wrapper functions 
should be good enough. But, you may 
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have need of more control over your 
request. In these cases, the forecast.io 
module has a function called ‘manualO’. 

You can use this to send a particular URL 
data request to the forecast.io service to 
pull back the exact information you are 
interested in. 

The last option we will look at is the I 
python-weather-api module. This I 
module provides access to weather 
service providers such as Yahoo! 
Weather, weather.com and NOAA. This 
module is actually available as a package 
within Raspbian. You can install it with 
the command: 

I sudo apt-get install python- 
pywapi 

You can also install it with pip. Once 
you have it installed, you can import it 
and request data from any of the three 
data service providers. The three main 
functions are: 

pywapi.get_weather_frorti_yahoo() 

pywapi.get_weather_from_weather_ 

com() 

pywapi.get_weather_from_noaa() 

These functions essentially get all of 
the available information from these 
different servers in a single call. You 
can then parse the results to pull out 
the information you are most interested 
in. The results actually come back as 
XML data and are then parsed in the 
return object. You can then pull out the 
relevant data by using keywords, such 
as ‘forecasts'. You should review the 
module documentation to see what 
information is available from each of the 
data sources. 

Once you have collected the weather 
data that you were looking for, you need 
to display this information. The simplest 
is to Just print it out. This works well if 
you are using a console as the interface. 
There are also several LCD options 
available if you want to make a self- 
contained weather reporting service. 
The exact code used to handle the LCD 
will vary by manufacturer, but they all , 
have very good documentation available. 
Now that you have weather reports being 
served to you, you will no longer have 
any excuses for being caught unawares 
by a storm or for showing up to work 
drenched bythe rain. 


Full code listing 

# To talk to Weather Underground we need 

# to import modules to handle URLs and 

# JSON data 
import urllib2 
import json 

# The next step is to open a URL and 

# read the data 

f urllib2 . urlopen ( ‘ http : //api . wunderground . com/api/YOUR_KEY/ 

geolookup/conditions/q/IA/Cedar_Rapids . json ’ ) 
json_string f.read() 

# Now you can parse the JSON data 

# read off the information you need 
parsed_json json . loads(json_string) 
location parsed_json[ ‘ location ’ ] [ ‘ city ’ ] 

temp_f parsed_json[ ‘ current_observation ’ ] [ ‘ temp_f ’ ] 

# To talk to forecast.io you need to 

# import the forecastio module 
import forecastio 

# You need your API key and location 
apikey “YOURJIEY” 

latitude =36.4 
longitude = 46.567 

# The next step is to load the forecast data 

forecast - forecastio. load_forecast(apikey, latitude, longitude) 

# You can print out the available hourly data 

by_hour forecast. hourly () 

for hourly_data in by_hourly.data: 
print hourly_data 

# You can also get summaries 
by_day = forecast. daily () 
print by _day. summary 

# To use the Python weather API you need to 

# import the pywapi module 
import pywapi 

# Getting the weather from any of the 

# available sources is a single call 

# You will need to find and use the 

# appropriate location ID 

weather_com_result = pywapi . get_weather_f rom_weather_com( ‘ 10001 ’ ) 
yahoo_result pywapi . get_weather_from_yahoo( ‘ 10001 ’ ) 
noaa_result = pywapi.get_weather_from_noaa(‘KJFK’) 

# The data is now in a key/value pair 

# structure, ready to read off and used 

print weather_com_result [ ‘ current_condi tions ’ ] [ ‘ text ’ ] 
print yahoo_result [ ‘ condition ’ ] [ ‘ text ’ ] 
print noaa_result[ ‘weather’] 


Weather 

station 



You can use Python 
to log weather 
data and send 
it in to Weather 
Underground; 
justinstallthe 
required module 
with: pip install 
weather. This 
actually contains 
three separate 
submodules that 
need to be imported 
individually. Thefirst 
provides a number 
of conversion 
functions, as well 
as calculation 
functions such as 
‘weather.units.calc_ 
wind_chill{)’. The 
second, ‘weather, 
stations’, provides 
the capabilities to 
talk to the weather 
station over a 
serial connection, 
butthis module 
currently onlytalks 
to the Vantage and 
VantagePro.The 
third, ‘weather, 
services’, provides 
the functions to 
upload yourdatato 
the online services. 



Print wirelessly with 
your Raspbeny Pi 

Breathe new life into an old printer by using your 
Raspberry Pi as a wireless print server 



Wireless printing has made it possible to print to devices 
stored in cupboards, sheds and remote rooms. It has generally 
shaken up the whole process of printing and enabled output 
from smartphones, tablets, laptops and desktop computers 
alike. But you don’t have to own a shiny new printer for this to 
work: old printers without native wireless support don’t have to 
end up in the bin, thanks to the Raspberry Pi. 

The setup is simple. With your Raspberry Pi set up with a 
wireless USB dongle, you connect your printer to a spare USB 
port on the computer. With Samba and CUPS (Common Unix 
Printing System) installed on the Raspberry Pi, all that is left to 
do is oonneot to the wireless printer from your desktop computer, 
install the appropriate driver and start printing. 

CUPS gives the Raspberry Pi a browser-based admin screen 
that can be viewed from any device on your network, enabling 
complete control over your wireless network printer. 


Check your printer works 

Before starting, check that the printer you’re planning to 
use for the project still works and has enough ink. The easiest 
way to do this is to check the documentation (online if you can’t 
find the manual) and run a test print. 
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Detect your printer 

With your Raspberry Pi set up as usual and the printer 
connected to a spare USB port, enter: 

I Isusb 

This will confirm that the printer has been detected by your 
Raspberry Pi. In most cases you should see the manufacturer 
and model displayed. 

Install Samba and CUPS 

Install Samba to enable file and print sharing across 
the entire network: 

I sudo apt-get install samba 
Next, install CUPS: 

I sudo apt-get install cups 

With a print server created, begin configuration by adding 
default user ‘pi’ to the printer admin group: 

I sudo usermod -a -G Ipadmin pi 


M Set up print admin 

Set up the CUPS print admin tool first. Boot into the 
GUI (startx) and launch the browser, entering 127.0.0.1:631. 

Here, switch to Administration and ensure the ‘Share 
printers' and ‘Allow remote administration' boxes are selected. 
Next, select Add Printer and enter your Raspbian username 
and password when prompted. 



Add your printer 

A list of printers will be displayed, so select yours 
to proceed to the next screen where you can confirm the 
details, add a name and check the Share This Printer box. 
Click Continue to load the list of printer drivers and select the 
appropriate one from the list. 

Configure Samba for network printing 

Using a Windows computer for printing? Samba will 
need some configuration. Open ‘/etc/samba/smb.conf in nano, 
search (Ctrl+W) for ‘[printers]’ and find ‘guest ok' which you 
should change as follows: 

I guest ok = yes 

Next, search for “[print$].”Then change the path as follows: 

I path = /usr/share/cups/drivers 


[ Begin configuration by addin 
the default user ‘pi’ to the 
printer admin group 


Join a Windows workgroup 

With these additions made, search for “workgroup" in 
the configuration file and add your workgroup: 

I workgroup = your_workgroup_name 
I wins support = yes 

Make sure you uncomment the second setting so that the print 
server can be seen from Windows. Save your changes and then 
restart Samba: 

I sudo /etc/init. d/samba restart 
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Accessing your printer on Linux 

Meanwhile, it’s a lot easier to access your wireless 
printer from a Linux, MacOSXorother Unix-like system, thanks 
to CUPS. All you need to do is add a network printer in the usual 
way and the device will be displayed. 
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Add AirPrint compatibility 

It's also possible to print wirelessly from your IPad 
using Apple’s AirPrint system. To do this, you need to add the 
Avahi Discover software: 

I sudo apt-get install avahi-discover 

Your wireless printer will now be discoverable from your iPad or 

iPhone and will be ready to print. 







Remotely control your 
Raspberry PI 

Use a web interface to control your Pi and employ It as a 
fileserver or media centre from a remote location using any 
web-connected device 


Basic 
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PID 2619-7 0 % 
PIO 2476 - 0 . 5 % 
PIO 2417 - 02 % 
PID 2273 - 0 . 2 % 
PID 2063 02 % 
PIO 2051 0 2 ** 


Commands Create custom 

commands for running your Raspberry Pi 


W 

other utilities Seeingthroughyour 

webcam and setting an alarm arejusttwo 
additional things you can do with your Pi 


Msin window CetthefuUdetails of 
the currently running system from the web 


What youll need 

■ Raspbiansetto 
command line 

■ RaspCTL 

■ Internet connection 


Not everyone uses the Raspberry Pi 
while it’s hooked up to a monitor like a 
normal PC. Due to its size and excellent 
portability, it can be located almost 
anywhere that it can be powered and 
it’s widely used as a file server, media 
centre and for other nontraditional 
applications as well. Some of these uses 
won’t easily allow access to a monitor for 
easy updates and maintenance. While 
you can always SSH in, it’s a bit slower 
than a full web interface that allows for 
custom commands and a view of the Pi’s 
performance. We’re using software called 
RaspCTL, which is still in development, 
but worksjust fine for now. 


Update your Pi! 

1 To make sure the Raspberry Pi works as best it can, you’ll 
need to update Raspbian. Do this with a sudo apt-get update 
&& apt-get upgrade, followed by a firmware update with sudo 
rpi-update. Finally, if you’re booting to LXDE, enter raspi- 
configand change it to boot to command line to save power. 





REMOTELY CONTROL YOUR RASPBERRY PI 


EditthelP 

For everything to work more easily, you should set the 
Raspberry Pi to have a static IP of your choice. To do this, edit the 
networkingconf ig by using: 

I $ sudo nano /etc/network/interfaces 


. . .and change iface ethO inet dhcp to iface ethO inet static. 



Set up a static IP 

Add the following lines under the iface line with your 
relevant details: 


address 192.168.1. [IP] 

I netmask 255.255.255.0 
network 192.168.1.0 
broadcast 192.168.1.255 
gateway 192. 168.1. [Router IP] 



your Raspberry Pi from anywhere on your network. To do this 
type the following into your address bar, with the IP being the one 
we set up earlier: 

I http://[IP]:8086 



Ready to install 

You’ll need to grab the public keys for the software 
we're going to install by using the following commands. The first 
will take just a moment to download the software, while the 
otherquickly installs it: 


1 $ wget debrepo.krenel.org/raspctl.asc 
$ cat raspctl.asc | sudo apt-key add - 



Add the repository and install 

Add the repository to the source's file with the 
following command: 


I $ echo “deb http://debrepo.krenel.org/ raspctl 
main” | sudo tee /etc/apt/sources. list. d/raspctl. 
list 


...and finally installthe software with: 

1 $ sudo apt-get update 
$ sudo apt-get install raspctl 


Change your password 

\Mw The default username and password is admin for both 
fields, and you should make sure to change that before doing 
anything else. Go to Configuration along the top bar and find 
the Authentication field at the bottom of the page. Input the 
original password (admin), followed by your new passwords. 
The username will remain as admin. 



First command 

Go to Commands on the top bar to begin creating 
commands to run. Here you'll need to add a class - a user- 
defined way to filter your commands that won’t affect the way 
it’s run - a name for the command and the actual command 
itself The commands won’t necessarily run from the pi user 
unless you tweak the config files. 


More functions 

The web interface has a few extra functions apart from 
running commands, such as the ability to view the webcam and 
connect to radio services. Updatingthe software every so often 
will also allow you to make sure it keeps working. Play around 
with it and see what best suits you. 




SOFWARE 


Turn your Pi into a motion 
sensor with SimpleCV 

Learn howto implement facial recognition into your 
Raspberry Pi using Python and o webcam 


Why 

Python? 



It’s the official 
language of the 
Raspberry Pi. 


Read the docs at 

python.org/doc 


The Kinect has proven a popular piece 
of tech to use with the Raspberry Pi. But 

not everyone has access to this kind of 
hardware. Another class of project that 
is popular with Raspberry Pis is using 
USB cameras to create monitors of one 
form or another. A lot of these projects 
use command line applications to talk to 
the USB camera and generate images 
or movies that are used as part of the 
system. But what if you are writing your 
own program in Python and you want to 
add some form of image system to your 
code? Luckily, there are several modules 
available for you to choose from. In this 
article, we will take a look at using SimpleCV 
to get your program to talk with the USB 
camera. SimpleCV is built on top of OpenCV, 
making it easier to use for common tasks. 
Assuming you are using Raspbian, you 
can go to the main page for SimpleCV 
(www.simplecv.org) and download a DEB 
file. To install it, you can simply run: 

I sudo dpkg -i SimpleCV-l.31.deb 

Before you do, however, you will want to 
install all of the dependencies. You can do 
that with the command: 

I sudo apt-get install python 
python-support python-numpy 
python-scipy ipython python- 
opencv python-pygame python- 
setuptools 

You can check that everything worked 
by running the command ‘simplecv’ at 
the command line. This will start Python 
up and run the interactive shell that is 


provided by the SimpleCV module. You 
can then try connecting to your USB 
camera and pullingimagesfrom it 

Now that everything should be up and 
running, how do you actually use it in your 
own code?You can load all ofthe available 
functions and objects into the global 
scope with the command: 

from Simplecv import * 

Making sure that you have your USB 
camera plugged in, you can now create a 
camera object with: 

cam = CameraO 

This will load the required drivers, and 
initialise the camera so that it is ready 
to start taking pictures. Once this object 
creation returns, you can grab an image 
from the camera with: 

img = cam.getImageO 

At least in the beginning, when you are 
experimenting, you may want to see what 
this image looks like. You can do this with: 

img.showO 

You will, of course, need to have a GUI 
up and running in order to actually see 
the movie. Otherwise, you will get an 
error when you try and call ‘img.showO’. 
Don’t forget that you can always pull up 
documentation with commands like: 

help(cam) 

help(img) 


With the ‘Image’ object, you can do some 
basic processing tasks right away. You 
can scale an image by some percentage, 
say 90%, with ‘img.scale(90,90)’. You 
can also crop an image by giving it a 
start location and saying how many 
pixels across and how many up and 
down you want to crop to. This looks 
like ‘img.crop(100,100,50,50)’. SimpleCV 
has the location (0,0) as the top-left 
corner of an image. 

The really interesting functionality in 
SimpleCV is the ability to find features 
within an image and to work with them. 
One of the clearest features you can look 
for is blobs, where blobs are defined as 
continuous light regions. The function 
‘img.findBlobsO’ will search the captured 
image for all blobs and return them as a 
FeatureSet. You can set the minimum 
number of pixels to consider a single 
blob, the maximum number of pixels, 
as well as a threshold value. If you are 
looking at a region that has some hard 
edges, you can use the function ‘img. 
findCornersO’. This function will return 
a FeatureSet of all of the corners within 
the captured image. A very simple 
monitor program could use one of these 
functions to see if there is any motion 
happening. If there is, then the set of 
blobs or corners will change from one 
frame to another. Of course, a little 
more reading will lead you to the ‘img. 
findMotionO' function. This function will 
take two subsequent images and see if 
any motion can be detected going from 
one to the other. The default method is to 
use a block matching algorithm, but you 
can also use either the Lucas-Kanade 
method orthe Horn-Schunck method. 

The above methods will let you know 
some features of the captured images, 
and if any kind of motion has occurred. 
But what if you are more interested in 
identifying whether people have been 
moving around? Maybe you have an 
area you need to secure from espionage. 


I SimpleCV is built on top of 
OpenCV, making it easier to 
use for oommon tasks 
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r You can look for blobs - 
continuous light regions 


In this case, you can use the function 
‘img.findSkintoneBlobsO’. You can use 
a binarise filter threshold to set what 
constitutes a skin tone. If you need to 
do more, you have access to all of the 
underlying OpenCV functionality. One of 
these more advanced functions is face 
recognition. You can use the function 'img. 
findHaarFeaturesO’ to look for a known 
type of object. If you wanted to look for 
faces, you could use something like: 


Above Any basic USB webcam or 
surveillance monitor will do forthis 


Full code listing 


# SimpleCV provides a simple interface to OpenCV 

# First, we will import everything into the local 

# namespace 


from SimpleCV import * 


# Make sure your USB camera is plugged in, 

# then you can create a camera object 

cam Camera 0 


faces HaarCascade(“./SimpleCV/ 
Features/HaarCascades/face. 
xmT’,“myFaces”) 
img.findHaarFeatures(faces) 


# Getting an image from the camera is straightforward 
img cam.getImageO 

# You can rescale this image to half its original size 
img2 img.scale(50,50) 


Importin 


When you start developing these types 
of programs, one thing that might come 
into play is timing issues. You want to 
be sure that your code is fast enough 
to catch everyone that may be moving 
through the field of the camera. In order 
to figure out what is costing time, you 
need to be able to profile your code. The 
shell in SimpleCV provides a feature 
called 'timeif that will give you a quick 
and dirty profiling tool that you can 
use while you are experimenting with 
different algorithms. So, as an example, 
you can see how long the ‘findBlobsO’ 
function takes on your Raspberry Pi with 
something like: 


# There are several features that you may want to look at 

# You can extract a list of blobs 
blobs img. findBlobsO 

# You can draw these blobs and see where they are on 

# the image 
blobs. draw() 

# or a list of corners 
corners img.findCornersO 

# If you want to identify motion, you will need two 

# frames 

img2 cam.getImageO 

# You can get a FeatureSet of motion vectors with 
motion img2.findMotion(img) 


img = cam.getImageO 
timeit img. findBlobsO 

Once you find and fix the bottlenecks in 
your code, you can create the end product 
for your final version. 

With this article, you should now have 
enough to start using cameras from 
within your own programs. We have only 
been able to cover the bare essentials, 
however, so don’t forget to go check out 
the documentation covering all of the 
other functionality that is available in the 
SimpleCV module. 


# Face recognition is possible too. You can get a list of 

# the types of features you can look for with 
img.listHaarFeaturesO 

# For faces, you can generate a Haar Cascade 
faces HaarCascadeC face, xml’) 

# Now you can search for faces 
found_faces img.findHaarFeatures(faces) 

# You can load image files with the Image class 
my_img Image(‘my_image. jpg’) 

# You can save images to the hard drive, too 
img. save ( ' camera . png’ ) 


SimpleCV is built on top of OpenCV and 
provides a simplified set of functions. 
But what can you do if you have more 
complicated work to do? You always have 
the option of using OpenCV directly to 
gain access to the full set of functions. 
You can import the module into the local 
namespace with: 

from cv2 import * 

Not only do you have the usual image 
manipulation functions and the feature 
recognition tools, but you also have the 
ability to process video. You can use 
meanshift and camshift to do colour 
based motion detection. There are 
functions to look at optical flow. These 
look at apparent motions in a video, from 
one frame to the next, that are caused by 
either the object moving or the camera 
moving. You can even subtract the 
background from a moving foreground 
object. This is a common preprocessing 
step in vision systems. You can even 
construct 3D information from a set 
of stereo images gathered by a pair of 
cameras. With OpenCV, you really can 
deal with almost any vision problem you 
might be tackling. 
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What youll need 

Raspberry Pi 2 

USB sound card (we used 
a Behringer UCA202) 


G)de a simple synthesiser 

Learn how to write a simple polyphonic synthesiser (and the 
theory behind it) using Python and Cython 


We are going to take you through the basics of wavetable 
synthesis theory and use that knowledge to create a real- 
time synthesiser in Python. At the moment, it is controlled 
by the computer keyboard, but it could easily be adapted to 
aocepta MIDI keyboard as input. 

The Python implementation of such a synthesiser turns out 
to be too slow for polyphonio sound (ie playing multiple notes 
at the same time) so we'll use Cython, which compiles Python 
to C so that you can then compile it to native machine code to 
improve the performanoe. The end result is polyphony of three 
notes, so this is not intended for use as a serious synthesiser. 
Instead, this tutorial will enable you to beoome familiar with 
synthesis oonoepts in a comfortable language: Python. 

Once you’re finished, try taking this project further by 
customising the mapping to better fit your keyboard layout, or 
tweaking the code to read input from a MIDI keyboard. 


Install packages 

Using the latest Raspbian image, install the required 
packages with the following commands: 

I sudo apt-get update 
I sudo apt-get upgrade 

I sudo apt-get install python-pip python2.7-dev 
portaudiol9-dev 

I sudo pip install cython pyaudio 

The final step compiles Cython and PyAudio from source, so you 
might want to go and do something else while it works its magic. 

Disable built-in sound card 

We had issues getting the Raspberry Pi’s built-in sound 
card to work reliably while developing the synthesis code. For 
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Cython 


Cython is a tool that compiles Python down to the C code that 
would be used bythe interpreterto run the code. This hasthe 
advantage that you can optimise some parts of your Python code 
into pure C code, which is significantly faster. This is achieved by 
givingC types, such as int, float and char, to Python variables. 

Once you have C code it can then be compiled with a C 
compiler {usually GCC) which can optimise the code even 
further. A downside to using Cython is that you can’t run Cython 
optimised code with a normal Python interpreter. Cython is a nice 
compromise because you get a similar simplicity to Python code 
but higher performance than usual. Cython has a prof iler which 
you can run using: 


' cython -a synth.pyx 


I 


The profiler outputs a htmlfile which shows where any 
optimisations can be made, givingyou an insight into just how 
much overhead using Python introduces. For more details you 
can goto http://cython.org. 


that reason, we are using a USB sound card and will disable the 
built-in card so that the default card is the USB one: 

sudo rm /etc/modprobe.d/alsa* 

I sudo editor /etc/modules 

Change ‘snd-bcm2835' to ‘#snd-bcm2835’ and save, then: 


Full code listing 


#! /usr/bin/python2 


step 07 


import pyaudio 

import time 

frcxn array import * 

fron cpython cimport array as c_array 

import wave 

import threading 

import tty termios sys 

MIDITable: 

# Generation code from 

# http: //www.adaihbuckley. net/software/beep. c 


init (self) : 

self notes [ ] 
self fill_notes ( ) 


fLLl_notes ( self ) : 

# Frequency of MIDI note 0 in Hz 
frequency ^ 8.175799 


# Ratio: 2 to the power 1/12 
ratio - 1.0594631 


i in range(0, 128): 

self notes append (frequency) 

frequency frequency * ratio 


I sudo reboot 

Test sound card 

Now we can test the USB sound card. Type alsamixer and 
then ensure that the volume is set to a comfortable level. If you’re 
plugging speakers in, you’ll probably want it set to 100%. Then 
type speaker-test, which will generate some pink noise on the 
speakers. Press Ctrl+C to exit once you are happy that it’s working. 


get_note ( self , n ) : 

self notes [n] 


step 08 


cdef float attack, decay, sustain_aiTplitude 

cdef float release, multiplier 

cdef public char state 

cdef int samples_per_ms, samples_gone 



M Start project 

Start by creating a directory for the project. Then 
download one cycle of a square wave that we will use as a 
wavetable, like so: 

I mkdir synth 
cd synth 

wget liamfraser.co.uk/lud/synth/square.wav 


init (self, sample_rate) : 

self attack 1.0/100 
self decay 1.0/300 
self sustain_amplitude - 0.7 
self release i.0/50 
self state ' 'A' 
self multiplier ' 0.0 

self samples_per_ms “ int( sample_rate , 1000) 
self samples_gone = 0 


Create compilation script 

We need a script that will profile our Python code 
(resulting in synth.html). Generate a Cython code for it and 
finally compile the Cython code to a binary with GCC: 

editor compile. sh: 

#!/bin/bash 

cython -a synth.pyx 

cython —embed synth.pyx 

gcc -march=armv7-a -mfpu=neon-vfpv4 -mfloat- 
abi=hard -03 -I /usr/include/python2.7 -o synth. 
bin synth. c -lpython2.7 -Ipthread 

(Notice the options that tell the compiler to use the floating 
point unit.) Make it executable with: 


• next_val ( self ) : 

self samples_gone i- 1 

self samples_gone > self saiTples_per_ms : 
self samples_gone “ 0 

m self multiplier 

self state 'A' : 
self multiplier - self attack 
self multiplier >= 1: 
self state 'D' 
self state “ 'D': 
self multiplier -- self decay 

self multiplier <= self sustain_amplitude : 
self state 'S' 
self state - 'R': 
self multiplier self release 



I chmod +x compile. sh 


self multiplier 
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Full code listing (Cont.) 


step 09 


cdef Note: 

cdef int wavetable_len 
cdef float position, step_size 
cdef c_array array wavetable 
cdef public float freq 
cdef public object adsr 
cdef public int off 

init (self, wavetable, samplerate, freq): 

n Reference to the wavetable we're using 

self wavetable wavetable 

self wavetable_len len ( wavetable ) 

# Frequency in Hz 
self freq freq 

# The size we need to step though the wavetable 

# at each sample Lo get the desired frequency, 
self step_size - self wavetable_len * \ 

( freq float ( samplerate ) ) 

^ Position in wavetable 
self position - 0.0 
^ ADSR instance 
self adsr ADSR ( samplerate ) 

# Is this note done with 
self off 0 

’ • repr_ ( self ) : 

("Note: Frequency {0}Hz, " 

"Step Size - {1}") .format (self freq, 
self step_size) 


cpdef int next_saiTple( self ) : 

# Do the next sairple 

cdef int pos_int, pi, p2, interpolated 
cdef int out_sample - 0 
cdef float pos_dec 
cdef float adsr 

adsr self adsr next_val ( ) 

^ Need to turn the note off 

# synth will remove on next sample 

adsr < 0: 
self off 1 

out_sample 

pos_int int (self position) 
pos_dec self position - pos_int 

^ Do linear interpolation 
pi “ self wavetable I pos_int ] 

p2 0 

# Wrap around if the first position is at the 
^ end of the table 

pos_int + 1 =- self wavetable_len: 
p2 self wavetable 1 0 ] 

p2 self wavetable lpos_int+l] 

Inerpolate between pi and p2 
interpolated - int (pi ^ ( (p2 pi) * pos_dec)) 
out_sample int ( interpolated * adsr) 

# Increment step size and wrap around if we've 

# gone over the end of the table 
self position ' “ self step_size 

self position >= self wavetable_len : 
self position self wavetable_len 


start to code 

Our code file is going to be called synth. pyx. This 
extension tells Cython that it is not plain Python code (and as 
such, can't be ran in a normal Python interpreter). Create the 
file with yourfavourite editor and add the imports. 


fvy MIDI Table 

To synthesise the standard note of a piano, we need 
a table of MIDI values. MIDI notes range from 0-127. MIDI note 
60 is middle C on a piano. The MIDI Table class has a ‘get note’ 
function that returns the frequency of a note when you give it 
a MIDI note number. 



Above Avisual representation of an Attack, Decay, 

Sustain, Release curve 

Attack, Decay, Sustain, Release 

The ADSR class applies a volume curve over time to the 
raw output of an oscillator. It does this by returning a multiplier 
to the note that is a multiple between 0.0 and 1.0. The version 
we provide has an attaok time of 100 ms, a decay time of 300 
ms and a release time of 50 ms. You can try changing these 
values to see how it affects the sound. 

The ADSR class does a lot of maths (44,100 times per 
second, per note). As such, we want to give types to all of the 
variables so that the maths can be optimised into a raw C loop 
where possible, because Python has a massive amount of 
overhead compared to C. This is what the cdef keyword does. 
If cdef public is used, then the variable can also be accessed 
from inside Python as well. 


Generate notes 

The note class is the core of our synthesiser. It uses 
the wavetable to generate waves of a specific frequency. The 
synthesiser asks the note class for a sample. After generating a 
sample, the ADSR multiplier is applied and then returned to the 
synthesiser. The maths of this are explained in the synthesis 
theory boxout on the opposite page. 

The note class does as much maths as the ADSR class, so 
it is optimised as much as possible using cdef keywords. The 
cpdef keyword used for the next_sample function means that 
the function can be called from a non-cdef class. However, the 
main synth class is much too complicated to give static types 
to absolutely everything. 

The audio flow 

This synth class is the main class of the application. It 
has two sample buffers that are the length of the buffer size. 
While one buffer is being played by the sound card, the other 
buffer is being filled in a different thread. Once the sound card 
has played a buffer, the callback function is called. References 
to the buffers are swapped and the buffer that has just been 
filled is returned to the audio library. 

The smaller the buffer size, the lower the latency. The 
Raspbian image isn’t optimised for realtime audio by default so 
you may have trouble gettingsmall buffer sizes. It also depends 
on the USB sound card used. 




CODE A SIMPLE SYNTHESISER 


Full code listing (Cont.) 


step 09 


out_sainple 


Synth : 

BUFSIZE “ 1024 
SAMPLERATE 44100 

_init_ (self): 

self audio pyaudio PyAudio() 

^ Create output buffers 

self buf_a array("h', [0] * Synth BUFSIZE) 
self buf_b array("h', [0] * Synth BUFSIZE) 

# Oldbuf and curbuf are references to buf_a or 

# buf_b, not copies. We're filling nev±)uf 

# while playbuf is playing 
self playbuf self buf_b 
self newbuf self buf_a 

self load_wavetable ( ) 
self notes [ ] 
self notes_on [ ] 

# The synth loop will run in a separate thread. 

# We will use this condition to notify it when 
^ we need more samples 

self more_saiTples ' threading Event ( ) 
self exit threading Event ( ) 

^ MIDI table of notes -> frequencies 
self midi_table MIDITable ( ) 

* • stop (self): 

\m "Exiting" 
self exit set( ) 
self stream stop_stream( ) 
self stream close () 

’ stream_init ( self ) : 
self stream self audio open( 

format pyaudio paint 16, 
channels ' 1, 
rate Synth SAMPLERATE, 
output True , 

frames_per_buffer Synth BUFSIZE, 
stream_callback self callback) 

: : • ’ load_wavetable ( self ) : 

# Load wavetable and assert it is the 

# correct format 

fh wave open ('square wav', 'r') 
f h getnchannels ( ) 

f h getframerate ( ) Synth SAMPLERATE 
■5 fh getsampwidth( ) 2 # aka 16 bit 

# Read the wavedata as a byte string. Then 

# need to convert this into a sanple array we 

# can access with indexes 

data - fh readf rames ( f h getnframes ( ) ) 

# h is a signed short aka i.ntl6_t 
self wavetable array('h') 

self wavetable fromstring(data) 

swap_buffers ( self) : 
tmp - self playbuf 
self playbuf self ne^uf 
self newbuf '■ tmp 

Setting the condition makes the synth loop 


Synthesis theory 

Wavetable synthesis is where you use a single cycle of a 
wave as a lookup table to synthesise sound. In this oase we 
have a square wave, but you oan load any wave shape you 
like. CD-quality audio has a sample rate of 44,100 Hz, which 
is what we used in our implementation. At each sample, the 
synthesiser outputs a value from the wavetable and then 
increments a position pointer to the next value in the table. 
However, ifthe wavetable has a frequency of 440 Hz then we 
need to be able to step through it at arbitrary sizes (ie non- 
integer values). To achieve this, we use linear interpolation. 
Assuming the table had a frequency of 440 Hz and we 
wanted afrequency of 220 Hz, we’d need to step through the 
table at a step size of 0.5. This can bethought of as drawing 
a line between two values in the table and picking a value on 
the line as your output. As an example, if element 0 is 5 and 
element 1 is 10 then element 0.5 would be 5 + ((1 0-5) * 0.5), 
which gives us a value of 7.5. When you reach a position that 
goes over the end of the table, you wrap around and start 
again. There is no discontinuity as you’re storing a single cycle 
of the wave in the table. The equation for step size is: 

I step_size = table_size * (note_frequency / 
sample_rate) 

The wavetable oscillator gets us a note at the desired 
frequency, but it's always at maximum amplitude and will 
sound rough and unnatural. If you cutoff a wave in the middle 
of a cycle there will be a pop or click, so this is where Attack, 
Decay, Sustain and Release envelopes help. These change 
the amplitude of the raw oscillator output overtime to sound 
more like an instrument. This is done by applying a fractional 
multiplierto the original sample point returned by the wave 
table oscillator. Havinga release time from 100% volume to 
0% means that a note will fade out smoothly when it’s turned 
off With the right ADSR curves and the correct wavetable, a 
synthesiser can sound very similarto real instruments. 

More information can be found at: bit.ly/1Kgl9dp. 





Above Here’s one cycle of a wavetable oscillator 


101 




SOFTWARE 


Performance 

issues 


Python introduces a number of performance issues 
compared to a native synthesiser implementation that 
is written in C or C++. Cython has been used in our 
implementation to try and mitigate these issues but it is 
nowhere near enough. As a rough comparison, our expert 
worked on a synthesis project targeting 100 Mhz ARM 
processors that were programmed in C and could get 
around 30 notes of polyphony, compared to three in this 
implementation on a 900 Mhz ARM core. 

A major issue is that the sound card uses 16-bit signed 
integers to represent a sample. However, Python doesn’t 
natively support this type. To pass the data to the audio 
library it needs to be encoded from an array of integers into 
a byte string. Then at the other end, the Python that talks 
to the audio library will decode this byte string back into 
an integer array. If it was written in C or another lower-level 
language like C++ or Rust, the sample could be passed 
almostdirectlytothe audio hardware. 

Another issue is that Python has a large function call 
overhead. In compiled languages, this can be optimised 
out by compilingfunotion calls in line with the caller 
(effectively, copying the code from the function into the 
caller). Variable access also has overhead because of all 
the type checking required. There is also the overhead 
of the garbage collector, which destroys 
objects when there are no longer 
references to them. 



' A major issue is that the sound 

I oard uses 16 -bit signed integers 
to represent a sample. However, 
Python doesn’t support this type 


Full code listing (Cont.) 

# generate more samples 
self more_samples set( ) 


step 11 


callback ( self , in_data, frame_count, 
time_info, status): 

# Audio card needs more samples so swap the 

# buffers so we generate more sairples and play 

# back the play buffer we've just been filling 
self swap_buffers ( ) 

(self playbuf tostring(), 
pyaudio paContinue) 

do_sample(self, int i): 
cdef int out_sample 0 

# Go through each note and let it add to the 
^ overall sample 

note in self notes: 
note off: 

self notes remove (note) 

out_sample note next_sample ( ) » 3 

self ne^uf [ i ] out_sample 

synth_loop ( self ) : 
cdef int i 


step 12 


self exit is_set() — False: 

# For each sample we need to generate 

i in range ( 0 , Synth BUFSIZE ) : 
self do_sample(i) 

# Wait to be notified to create more 
samples 

self more_saiTples clear ( ) 
self more_saiTples wait ( ) 

start ( self ) : 
self stream_init ( ) 

# Start synth loop thread 

t threading Thread (target self synth_loop) 
t start ( ) 

freq_on(self , float freq) : 

n Note (self wavetable, Synth SAMPLERATE, 
freq) 
n 

self notes append(n) 

freq_off (self , float freq): 

# Set the ADSR state to release 

n in self notes: 
n freq freq: 
n adsr state ord('R') 

note_on(self , n) : 

self freq_on(self midi_table get_note(n)) 
self notes_on append(n) 
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Synth loop 

I I The start method of the synth class initialises the audio 
hardware and then starts the synth_loop method in its own 
thread. While the exit event is set to false, the do_sample 
function is called. 

The do_sample function loops through the notes that are 
currently turned on and asks for a sample from each one. These 
samples are shifted right by three (ie divided by 2''3) and added 
to ouLsample. The division ensures that the output sample 
can't overflow (this is a very primitive method of adding notes 
together, but it works nonetheless). 

The resulting sample is then put in the sample buffer. Once 
the buffer is full, the more_samples condition is cleared and 
the synth_loop thread waits to be notified that the buffer it 
has just built has been sent to the audio card. At this point, the 
synth can fill up the buffer that has Just finished playing and 
the cycle continues. 


Turn on notes 

There are both note_on/off and freq_on/off functions 
that enable either MIDI notes or arbitrary frequencies to be 
turned on easily. Added to this, there is also a toggle note 
function which keeps track of MIDI notes that are on and turns 
them off if they are already on. The toggle note method is used 
specifically for keyboard input. 


B Add keyboard input 

For keyboard input, we needed the ability to get a 
single character press from the screen. Python's usual input 
code needs entering before returning to the program. Our 
code for this is inspired by: https://code.activestate.com/ 
recipes/577977-get-single-keypress. 

There is a mapping of letters on a keyboard to MIDI note 
numbers for an entire keyboard octave. We have tried to 
match the letter spacing to how a piano is laid out to make 
things easier. However, more innovative methods of input are 
left as an exercise to the reader. 


Full code listing (Cont.) 


step 12 


Step 13 


note_off (self , n) : 

self - freq_aff( self midi_table get_note(n)) 
self notes_on reinove(n) 

toggle_note ( self , n ) : 
n in self notes_on: 

"note {0} off". format (n) 
self note_off(n) 

"note { 0 } on" . format ( n ) 
self note_on(n) 

KBInput: 

• init_ (self, synth): 

self synth synth 


self keymap 


self notes on 


{'a' : 60, 'w' 
^e' : 63, 

"t' : 66, "g' 
^h' : 69, 

: 72} 

[] 


61, 

' s ' 

: 62 

64, 

'f ' 

: 65 

67, 

'y' 

: 68 

70, 

' j' 

: 71 


@ staticmethod 
getch( ) : 

fd sys stdin fileno( ) 
old_settings termios tcgetattr ( f d ) 


tty setraw(fd) 
ch sys stdin read(!-) 


termios tcsetattr(fd, termios TCSADRAIN, 
old_settings ) 


ch 


loop ( self ) : 

True: 

c - self getch( ) 


M Put it all together 

The main function of the program creates an instance 
of the synth class and then starts the audio stream and synth 
loop thread. The start function will then return control to the 
main thread again. 

At this point we create an instance of the KB input class 
and enter a loop that gets characters and toggles the 
corresponding MIDI note on or off. If the user presses the 
Q key, that will stop the synth and end the input loop. The 
program will then exit. 

Compile the code 

Exityour editor and run the compile script by typing 
the following command: 


I . /compile. sh 


This may take around 30 seconds, so don't worry if it isn't 
instant. Once the compilation has finished, execute the synth. 
bin command using: 

I ./synth. bin 


Pressing keys from A all the way up to K on the keyboard will 
emulate the white keys on the piano. If you press a key again 
the note will go off successfully. 


c 'q': 
self synth stop( ) 


c in self keymap: 
n self keymap[c] 
self synth toggle_note(n) 

name " main " : 

s Synth ( ) 
s start ( ) 
kb KBInput ( s ) 
kb loop( ) 



Above The simple user interface. Notice how the step size in the wavetable varies with frequency 
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BUILD A RASPBERRY PI CAR COMPUTER 


Build a Raspberry 
Pi car computer 

Make your own touchsaeen navigation 
system that gives directions, local weather 

reports and plays music 



Cars are getting clever. These days, with smart navigation 
interfaces built into new cars, you don’t need to go out and 
buy yourself a TomTom to get help with directions. But if 
you’ve got a Raspberry Pi then you don’t even need to buy 
that - let alone a new car! 

In this project we will show you how to build your own 
car computer with your Pi, a quality touchscreen like the 
9-inch model from SainSmart that we’re using here, and a 
few other bits like a GPS module and USB 3G modem. Your 
CarPi will be able to use open source navigation software 
Navit to show your route map on screen, plus speech 
synthesis to read out directions, and it will also be able to 
check your location and give you weather reports. It’ll work 
asa music player too, of course. 

It’s an ambitious project, but you will gain a solid 
understanding of custom-made interfaces, navigation 
software and geolocation data, touchscreen calibration, 
speech synthesis and more. While you don’t have to use 
the same SainSmart screen as us, we do recommend it for 
this project as it is one of the few large touchscreens out 
there for the Pi. There are more improvements at the end 
too, so check the components list, make sure you’ve got 
everything and let’s get started! 
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Above We’re using 
Adafruit’s excellent 
GPS Breakout kit 
here: bit.ly/1G8X2gw 


Install navigation software 

Begin to instailthe Navit navigation software by entering: 


I sudo apt-get install navit gpsd gpsd-clients espeak 
sudo nano /etc/default/gpsd 
set START_DAEMON=“true” 


...and set 


Basic configuration 

Boot up your Raspberry Pi and expand the filesystem 
using raspi-config. Go to Advanced Options and disable the 
Serial connection - you'll need this to talk to the GPS module 
later. In raspi-config, enable X at boot as the pi user. Say Yes to 
reboot. Once rebooted, ensure your packages are up to date with: 

I sudo apt-get update 
sudo apt-get upgrade 


Connect GPS module 

Solder the pin headers onto the Adafruit GPS module. 
You can also solder the battery connector which is used to keep 
the device partially active, giving a faster fix. You only need to use 
4 pins: 3.3V, ground, serial transmit and serial receive. Power the 
Pi off again before connecting anything. 

As we are using GPS, the antenna will have to go outside or 
under a window to gain signal. Connect the antenna to the board 
and power everything back on. The light on the GPS module will 
flash frequently while finding a fix. Once it has one, it will blink 
every 15 seconds. 


DEVICES=”/dev/ttyAMA0” 

Start the GPS daemon with: 

I sudo /etc/init.d/gpsd start 

You can check it’s working by looking at the GPS data with: 

I cgps -s 

M Connect the screen 

The SainSmart screen doesn’t come with any written 
instructions. Instead there is a YouTube video on their website 
with details about how to put it together: bit.ly/1DF6eJJ. The 
important part is that the DC power supply should be 12V. 

Set the screen resolution 

We will have to force the correct resolution (1024x600) 
for the screen by editing /boot/config.txt with sudo. To do so, 
add the following options: 

framebuffer_width=1024 

framebuffer_height=600 

hdttii_force_hotplug=l 

hdmi_cvt=1024 600 60 3 0 0 0 

hdmi_group=2 

hdmi_rrode=87 

For the changes to properly take effect you will need to reboot 
with sudo reboot. 

Download kernel source 

To start the touchscreen, you need to compile an 
extra kernel module to support it. The program rpi-source 
(github.com/notro/rpi-source/wiki) will find the source of 
your kernel. Install rpi-source with: 

I sudo wget https://raw.githubusercontent.com/notro/ 
rpi-source/master/rpi-source -0 usr/bin/rpi-source 
&& sudo chmod +x /usr/bin/rpi-source && /usr/bin/ 
rpi-source -q -tag-update 

Then run rpi-source to get the source of the running kernel. 
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Update GCC 

\Jw Recent Raspberry Pi kernels are 
compiled with GCC 4.8. Raspbian only 
comes with 4.6 so you will have to install 
4.8 to continue with the following steps. 
Do this by entering: 


I sudo apt-get install -y gcc-4.8 
g++-4.8 ncurses-dev 


Then you have to set GCC 4.8 as 
the default: 

I sudo update-alternatives 

—install /usr/bin/gcc gcc /usr/ 
bin/gcc-4.6 20 
I sudo update-alternatives 

—install /usr/bin/gcc gcc /usr/ 
bin/gcc-4.8 50 
I sudo update-alternatives 

—install /usr/bin/g++ g++ /usr/ 
bin/g++-4.6 20 
I sudo update-alternatives 

—install /usr/bin/g++ g++ /usr/ 
bin/g++-4.8 50 


Pickthemoduletocompile 

Rpi-source puts the kernel 
source in a folder called ‘linux’. To 
choose the USB Touchscreen Driver, 
enter the following: 


cd linux 

I make menuconfig 

Device Drivers -> Input device 
support -> Generic input layer 
(needed for keyboard, mouse, 

...) -> Touchscreens (press space 
to include) -> USB Touchscreen 
Driver (press M to make module) 


Once you’ve done that, you then need 
to make sure you save your changes as 
‘.config’ and run scripts/diffconfig to see 
the differences. 


Full code listing 


import os, sys , requests, pygame 

from gps import * 

from pygame. locals import * 

WeatherClient: 

apikey = “7232alf6857090f33b9dlc7a74721” 

@staticmethod 

latlon(); 

gpsd = gps (mode WATCH_ENABLE) 


True: 

report - gpsd.next() 

report! ‘class’] == ‘TPV’: 
gpsd . closeO 

report! ‘ laf ] , report!‘lon’] 
None, None 


@staticmethod 
he- usefuldata(j) : 

d - j!‘data']!‘current_condition’]!0] 

out = “Now - Temp: {0}C, Feels Like: {1}C, Description: {2}\n”\ 
format (d! ‘ temp_C ’ ] , 

d!‘FeelsLikeC’], 
d!‘weatherDesc’]!0]!‘ value’]) 

hourly ^ j ! ‘ data ’]! ‘weather ’] !0] ! ‘ hourly ’ ] 

hour_count 

h in hourly: 

out += (“+{0}hr - Temp: {1}C, Feels Like: {2}C, Chance of Rain: 
“ {3}%, Description: {4}\n”)\ 

. format(hour_count , 
h!‘tempC’] , 
h!'FeelsLikeC’], 
h!‘chanceofrain’], 
h! ‘ weatherDesc ’ ] !0] ! ‘ value ’ ] ) 

hour_count += 1 


AA Compile and install 
the module 

Now you need to compile and install the 
module. Do so by entering: 


make prepare 

make SUBDIRS=drivers/input/ 
touchscreen modules 
I sudo make SUBDIRS=drivers/input/ 
touchscreen modules_install 
I sudo depmod 


If you unplug and reconnect the 
touchscreen, it should work fine but it 
will probably need calibrating. 


out.rstripO 

Sstatiemethod 
update!) : 

errstr = “Error getting weather data” 

lat. Ion WeatherClient latlonO 
lat - None or Ion == None: 
errstr 


api_req ■ (“http: //api . worldweat heronline . com/free/v2/weather . ashx” 
“?q={0}%2C{l}&format=json&key={2}”) . format(lat , Ion , 

WeatherClient . apikey) 


r None 
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SainSmart’s 
9-inch HDMI/VGA 
touchscreen (bit. 
ly/1Ciu4H9) has a 
fantastic display 
and is perfect 
for all sorts of 
Pi projects 


Adafruit’s Ultimate 
GPS Breakout kit 
provides Navit 
and the weather 
function with the 
location data that 
they require 


The screen 
control panelthat 
comes with the 
SainSmart screen 
enables you to 
easily change the 
display settings 
(i.e. brightness, 
contrast, etc) as 
wellasthe input 
(i.e.HDMI,VGA, 
AVI, etc) 


As wellasthe main 
controller board, 
the touch screen 
is connected to 
afour-line USB 
controller which 
then plugs into the 
Pi’s USB port 


Cali brate the touchscreen 

At this point, you can easily calibrate the touchscreen by 
entering the following: 

cd /etc/Xll 

sudo mkdir xorg.conf.d 
cd xorg.conf.d 

sudo nano 99-calibration. conf 



Download maps 

I I Navit needs maps; download them from maps.navit- 
project.org. You can either use the web browser on the Pi or 
download the map from another machine and copy it using 
scp. Use the predefined area option to select where you live. 
The smaller the area that you pick, the less data you will have to 
process. Here the UK has a map size of 608 MB. Now move the 
map to the navit folder: 


. . .with the following content: 


Embed 
the screen 



We’ve looked at 
the PiTFT and the 
HDMIPi before, 
butthe SainSmart 
touchscreen 
we’re using here is 
uniquely suited to 
many embedded 
projects. It’s larger 
than the PiTFT but 
also withoutthe 
large bezels of the 
HDMIPi -and it’s 
incredibly thin -so 
it’s the kind of thing 
that is really useful 
for installation 
projects, whether 
that’s somethingas 
simple as a photo 
slideshow in a real 
picture frame ora 
home automation 
control interface 
embedded into a 
cupboard door. 


I Section “InputClass” 

Identifier “calibration” 

MatchProduct “eGalax Inc. USB TouchController” 
Option “SwapAxes” “1” 

Option “InvertX” “1” 

EndSection 

Invert X actually inverts Y because the axes have been swapped 
around. Reboot again for these changes to occur. Now the 
calibration is roughly correct, download an input calibratorthat 
Adafruit have packaged already. 

I wget http://adafruit-download.s3.amazonaws.com/ 
xinput-calibrator_0.7. 5-l_armhf.deb 

■ sudo dpkg -i xinput-calibrator_0.7.5-l_armhf.deb 
DISPLAY=:0.0 xinput_calibrator 

DISPLAY=:0.0 is useful because you can run the program from 
any terminal (including an SSH session) and have it appear on 
the touchscreen. Touch the points on the screen as prompted. 
Once the program is finished, you should get an output that is 
similar to the following: 

I Option “Calibration” “84 1957 270 1830” 

Add it to the ‘99-calibration.conf file that we created earlier 
Just below the other Option entries. 


I mkdir -p /home/pi/, navit/maps 

mv /home/pi/Downloads/$your_map /home/pi/. 
navit/$country. bin 

For example: 

I mv /home/pi/Downloads/osm_bbox_-9.7,49.6,2.2,61.2.bin 
/home/pi/. navit/maps/UK. bin 

Navit configuration 

Sudo-edit /etc/navit/navit.xml with your favourite 
editor. Search for openstreetmaps. Now disable the sample 
map above, enable the openstreetmap mapset and set the 
data variable to where you Just moved your map. In this case 
it looks like this: 

I <!— Mapset template for openstreetmaps — > 
<mapset enabled=“yes”> 

<map type=“binfile” enabled=“yes” data=“/home/ 
pi/. navit/maps/UK. bin”/> 

I </mapset> 

Then search forosd entries similar to: 

I <osd enabled=“yes” type=“compass”/> 

...and enable the ones you want - we reoommend enabling 
them all. You may want to zoom in closer than the default map 
layout. A zoom value of 64 is useful. 
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Sound configuration 

Iw Before configuring speech 
support for Navit, configure the external 
sound card. You have to stop the 
Broadcom module from loading and 
remove some Raspberry Pi-specific ALSA 
(Advanced Linux Sound Architecture). 
To do this, sudo-edit /etc/modprobe and 
comment out (i.e. prefix with a #): 


I snd-bcnn2835 


Then run: 

I sudo rm /etc/modprobe. d/alsa* 


Reboot for the changes to take effect. 
Use alsamixer to set the volume on the 
if it's too quiet. 


1/1 [download a voice 

l*T The speech synthesis software 
needs a voice and a proprietary 
binary. You can get both by completing 
the following steps: 


Full code listing 

r = requests . get(api_req) 

requests . exceptions . RequestException e : 

errstr 

WeatherClient usefuldata(r. json()) 

r , r CarLauncher: 

init (self) : 

pygame init() 

pygame mixer quit() 

screen_info ^ pygame display. Info() 

self screen pygame display set_mode((screen_info,current_w, 

screen_info, current_h)) 
pygame display . set_caption( ‘Car Launcher’) 
self titlefont pygame, font Font (None, 100) 
self wfont " pygame. font , Font (None, 30) 
self w_text “ None 

■ ' clean_background(self) : 

background - pygame, Surface(self. screen get_size()) 
self background = background convert() 
self background fill((0, 0, 0)) 


I sudo mkdir -p /usr/share/ 
mbrola/voices/ 

I wget http://www.tcts.fpms.ac.be/ 
synthesis/mbrola/dba/enl/enl- 
980910.zip 

unzip enl-980910.zip 
., sudo cp enl/enl /usr/share/ 
mbrola/voices 

I wget http://www.tcts.fpms.ac.be/ 
synthesis/mbrola/bin/raspberri_ 
pi/mbrola.tgz 
tar zxvf mbrola.tgz 
I, sudo mv mbrola /usr/local/bin/ 

IC Create speech script 

Navit supports speech by 
running an external script and passing 
the text to speak as an argument. 
Create one using: 


text = self titlefont render(“CarPi Launcher”, 1, (255, 255, 255)) 
textpos “ text get_rect() 

textpos. centerx = self background . get_rect() . centerx 
self background blit(text, textpos) 

self screen blit(self background, (0,0)) 
pygame display . flipO 

main_menu(self) : 

self btns = {‘Music’ : None, ‘NAV’ : None, ‘Weather’ : None} 

item_num = 1 

key in self btns: 

text = self , titlefont , render(key, 1 , (255,255,255)) 
textpos = text,get_rect() 

max_width = self background get_rect() .width len(self btns) 
center_offset = max_width * 0.5 


t cd /home/pi/, navit 
) wget http://liamfraser.co.uk/ 
lud/carpi/chime.wav 
touch speech. sh 
i chmod +x speech. sh 


textpos. centery = self , background , get_rect() . centery 2 

textpos, centerx = (max_width * item_num) - center_offset 

self btns[key] = textpos 

self screen blit(text, textpos) 

item_num 1 


Now edit speech. sh: 


pygame display . flip() 


#!/bin/bash 

aplay -r 44100 /home/pi/, navit/ 
chime.wav 

I espeak -vmb-enl -s 110 -a 150 
-p 50 ‘‘$1” 

Finally, test it with: 

I . /speech. sh “Hello World” 


select_rect(self , rect, text): 

surface - pygame. Surface((rect,w, rect.h)) 
surface. fill((0, 255, 0)) 

t = self titlefont, render(text, 1, (255,255,255)) 

surface blit(t, (0,0)) 

self. screen blit(surface, rect) 

pygame display . flip() 
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Above The Navit software comes with a host 
of options built into its menu hierarchy 


Above The pympdtouchgui front-end for the 
music player is surprisingly featureful 


You will need to write your 
own launcherforCarPi 


Make it 
mobile 



It is definitely best 
to put this project 
together in a clean 
workspace so that 
you can clearly 
see what you’re 
working with and 
ensure everything is 
correctly wired and 
soldered, butthe 
point of the project 
is to make this setup 
portable so that you 
can put itinyour 
car and use it on 
the road. You could 
install everything 
into a single, hand- 
made enclosure or 
customise a large 
bought one, oryou 
could secure the 
various parts inside, 
for example, your 
gloveboxorcar 
doors. You’ll also 
need to power both 
the screen and your 
Pi with a power pack 
and ensure that 
the GPS antenna is 
fastened into a good 
spotforsignal. 


Configure Navit for speech 

The last part is simple. Edit the Navit config file again (/ 
etc/navit/navit.xml) and replace the following line: 

I <speech type=“cmdline” data=“echo ‘Fix the speech 
tag in navit. xml to let navit say:’ ‘%s”’ cps=“15”/> 


..with: 


<speech type=“cmdline” data=“/home/pi/. navit/ 
speech. sh %s” cps=“10” /> 


Now you can run Navit with DISPLAY=:0.0 navit and have 
fun experimenting. 


installthe music player 

99 MPD is the music player back-end and pympdtouchgui 
is the front-end that needs installing manually: 


I sudo apt-get install mpd ncmpcpp 

wget http: //WWW. spida . net/projects/software/ 
pympdtouchgui/pympdtouchgui-0.320.tgz 
I tar zxvf pympdtouchgui-0.320.tgz 
I cd pympdtouchgui-0.320/ 

I sudo python setup, py install 
I # Fix hard coded path in software 
I sudo In -s /usr/local/share/pympdtouchgui/ /usr/ 
share/pympdtouchgui 


Copy music 

Iw Sep (secure copy protocol) was used here to copy 
music. First get the Pi’s IP address by running ip addr. Then 


run sudo passwd to set a password for root From a computer 
with music on, run: 

I sep -r music_folder root@pi_ip_address:/var/lib/ 
mpd/music/ 

Then on the Pi, change the ownership of the music that 
you just copied: 

I sudo chown -R mpd:audio /var/lib/mpd/music 

1 A Update mpd music library 

17 Ncmpcpp is a command line client for mpd. Type 
ncmpcpp and press U to update the library. Press 3 to 
browse the library and check the music is there, and press 
Q to quit. Pressing 1 will select the help screen if you want 
to do more. 


install awesome window manager 

Now you will need to write your own launcher for 
CarPi, which will run full-screen. To ensure every application 
is forced to full-screen, use awesome window manager in full- 
screen mode. 


I sudo apt-get install awesome 

sudo rm /etc/alternatives/x-session-manager 
sudo In -s /usr/bin/awesome /etc/alternatives/x- 
session-manager 


When changing the default x-session-manager, awesome will 
be auto-started at boot instead of LXDE. If you reboot the Pi, 
awesome should then load up automatically. 
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Install the requirements 
foryour launcher 

The launcher is going to use a weather 
API combined with location data 
from the GPS receiver to give weather 
updates when requested. The nicest 
HTTP API for Python is requests, which 
you can install by doingthe following: 

u sudo apt-get install python-pip 
I sudo pip install requests 

Write the launcher code 

Creating the code itself is pretty 
self explanatory, but you can use our 
ready-made version by downloading the 
CarPi package from FileSilo.co.uk and 
extracting carlauncher/carlauncher.py. 


CarPi Launcher 
NAV Weather Music 


start the launcher 
automatically 

Sudo-edit/etc/xdg/awesome/rc.luaand 
move awful. layout.suit.max.fullscreen 
to the top of the layouts list. Add the 
followingtothe bottom ofthefile: 

I awful . util. spawn_with_shell(“/ 
home/pi/carlauncher/carlauncher. 

py”) 

Now reboot again and the launcher 
should come up automatically. 


CarPi Launcher 
NAV Wtailut Music 


I 


Future improvements 

There are a number of 

improvements that could be made 

to the base projeot atthis point: 

• Make the launcher switch between 
applications rather than start them 
again each time 

• Make the launcher look better 
aesthetically with icons 

• Use Mopidy instead of MPD so you 
can useSpotify 

• Further Navit configuration to make 
it more featureful 

• An SSD or USB flash drive for storage 
to makethings quicker 






Full code listing 

* reset(self): 
self clean_background() 
self main_menu() 
self render_weather() 

execute(self , path): 
os . systenn(path) 


self resetO 

render_weather (self) : 
self.w_text == None: 


margin = 10 

y - self btns[‘NAV’] bottomleft[l] + margin 
t in self . w_text . split(“\n”) : 

line self.wfont render(t.rstrip(), 1, (255,255,255)) 
line_rect line get_rect() 

line_rect . centerx = self background get_rect() . centerx 
line_rect.y y 

self. screen blit(line, line_rect) 
y += margin -r line_rect height 

pygame display . flip() 

handle_events(self , events): 
e in events: 

e.type QUIT: 
sys.exitO 

e.type — MOUSEBUTTONDOWN : 
pos pygame mouse, get_pos() 

btn_text, rect in self , btns , iteritems() : 
rect.collidepoint(pos) : 
self . select_rect(rect, btn_text) 
btn.text == “NAV”: 
self . execute (“/usr/bin/navit”) 
btn_text == “Music”: 

self execute (“/usr/local/bin/pympdtouchgui”) 
btn_text == “Weather”: 
self w_text - WeatherClient , updateO 

self. resetO 

loop(self) : 

clock “ pygame time. ClockO 
self resetO 


self handle_events (pygame . event , get()) 

clock. tick(5) 

._name == “ main ”: 

cl = CarLauncherO 
cl . loopO 






Components fist 


Raspberry Pi Model B+ 

3 DHT22 temperature- 
humidity sensors 

4 relay modules 
Outlet boxes 
LEDs 

2Mini5Vblowerfans 
2 2N222 transistors 
2 10K resistors 
10Q,0.5W resistor 


Below The Raspberry Pi itself sits just beside 
the vivarium, processing data from the DHT22s 


114 







HOW I MADE: RASPIVIV 


^ <^How I made: 
RasPiViv 

How con you keep poison dart frogs cosy? 


^ So, what do you keep in the vivarium? 

I Right now I have seven poison dart 
I frogs - they’re frogs from South 
America that, in the wild, excrete poison 
alkaloids, but in captivity, because 
their diet is just fruit flies, they can’t 
produce any poison. They’re something 
I’ve been interested in for quite a long 
time. I think I saw them first when I was 
in grade school at a trip to the Denver 
zoo, and I just thought they were the 
coolest animals I’d ever seen in my 
life. I’ve wanted to keep them since 
then but the opportunity never came 
up - they’re kinda rare - until I found 
a breeder on Craigslist who has an 
incredible collection and he breeds them 
to support his hobby. So right now I have 
a total of seven: two blue poison dart 
frogs, which I think could be a breeding 
pair, and I recently obtained five yellow- 
banded poison dart frogs. 

What kind of requirements do you have 
forthe vivarium, then? 

The temperature is really important, 
which a lot of people have trouble 
with because your house temperature 
is going to be about the same as an 
enclosed box, give or take, as lighting 
can heat things up. But you have 
to maintain specific temperatures 
between about 75 and 85 degrees. 
The humidity is even more important 
because the frogs use the it to 
thermoregulate similar to how we sweat. 

So basically, what I needed was a way 
to monitor and regulate the humidity. I 
looked around online for a couple of days 
trying to come up with a solution - a lot 
of people use little timers, and there are 
a couple of systems that are made for 
this but they don’t do very much. 

What hardwaredid you use to make your 
own solution? 

Well, the Raspberry Pi is set up as a 
LAMP server. I started playing around 
with the DHT22 temperature-humidity 
sensor - originally I just wanted to 
monitor that, the temperature and 
the humidity, but then I got into using 


relays to control the lighting and it just 
progressed further and further. I was 
just making this for myself and I posted 
on a forum. Then a lot of people seemed 
really interested, so I said I’d clean 
things up and throw together a guide 
(see www.raspiviv.com). 

So the temperature and humidity 
sensors are read every 60 seconds and 
logged into a database. Using WiringPi 
and Adafruit’s DHT22 sensor (and the 
driver for it, which works really well), 
lighting is controlled by regular relays or 
relay modules, and the fan isjust a basic 
transistor switch. The main idea behind 
the fan is that if the atmosphere is too 
saturated with water then the frogs can’t 
thermoregulate. So the database is read 
every five minutes, and when it reaches 
95% humidity it then kicks on the fan to 
blow in some fresh air. 

Do you SSH in to control all this or do you 
have a web interface? 

Yeah, there’s a whole web interface 
where you can check out the current 
readings. Check out the Demo section on 
my website and the first thing that pops 
up is my blue poison dart frog vivarium. 
It gives you the current temperature and 
humidity, and the readings for the last 
hour. If you click on the icon that looks 
like a grid of buttons (manual controls). 


you can manually control your lighting, 
any misting system or fans you have 
- essentially, for any component that 
you want to control, it’s just a matter of 
getting a relay module and wiring it up. 

Are you planning to upgrade the 
RasPiViv software at any poi nt? 

I hope to. I started work on this in my 
downtime and got insanely busy, so 
unfortunately I haven’t been able to do 
a lot with it. I’m hoping to get some RF 
power outlets soon so that, rather than 
wiring up a little power outlet box, you 
can just use these prebuilt outlets that 
you plug into your wall. I am hoping to 
implement some wireless stuff and 
I’d definitely like to make it more user 
friendly, rather than people manually 
adding cron jobs to things. I’d like them 
to be able to do it through the browser 
interface, stuff like that. 

What you don’t see in the demo is that 
there’s also a login system - you can 
make an account and keep it secure - so 
I want to give people that and I’ll run a 
tutorial for setting it up. I’ve been playing 
around with the Raspberry Pi camera 
module and hoping to include it, so now 
we have a Raspberry Pi 2 that is a lot more 
capable, it could potentially pull off some 
kind of live camera that you can watch as 
well as all the other stuff that it does. 
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Nate Bensing 

is a marketing 
consultant, 
photographer and 
graphic designerfor 
Wheaton Design in 
Northern Colorado. 
He enjoys learning 
about electronics, 
creating automation 
projects, and 
contributing as 
much as he can to 
the Raspberry Pi and 
Linux communities 
that have made all 
this possible. 

Like it? 

Fancy building 
your own Vivarium 
controller? Check 
out the excellent 
step-by-step guide 
on Nate’s website 
that takes you 
from NOOBS to the 
humidity regulation 
cron job (bit. 
ly/IHTKyeX). 

Further 

reading 

Looking for more 
inspiration for 
sensor-driven 
projects? There 
are some great 
ones featured on 
The Raspberry Pi 
Foundation blog, 
like the Feeder 
Tweeter and the 
PiPlanter: 
bit.ly/1Ak37mu. 


LeftThe RasPiViv 
web interface 
shows you the 
temperature and 
humidity readings 
overtime 
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AAake a Raspberry 
Pi sampler 

Build your own looping drum machine 
with only 200 lines of code! 



Left Extra breadboards are 
used hereto keep the main 
breadboard as free from 
wires as possible 


W 

What youll need 

■ Latest Raspbian image 

raspberrypi.org/downloads 

■ At least one breadboard 

■ Push buttons 

■ LEDs 

■ Female-to-male GPIO 
jumper cables 

■ Male-to-male GPIO 
jumper cables 


In this tutorial we combine electronics, music and 
programming knowledge to create a simple sampler with 
looping capabilities. The implementation used in this article has 
three drum sounds as the samples, but it is trivial to add more 
untilyou run out of GPIO pins. 

Before we start, I'll cover some basic musical terms. Music is 
split into bars. There are a certain number of beats in a bar. This 
sampler uses the 4/4 time signature, which means there are 4 
beats in each bar. Tempo is the speed at which music is played, 
and it is measured in beats per minute (bpm). A metronome is an 
audi ble tone that is heard at the start of every beat. 

Quantization is the process of aligning notes to beats, or exact 
fractions of a beat, and a quantization value is usually given in the 
form 1/8. This means that there are eight possible places in a bar 
where a note can be played. When the sampler is recording and 
a sample button is pressed, we store the sample at the current 
position in the bar with the accuracy of the quantize value. 
There’s a lot to cover, so let’s get started. 


Connect LEDs 

The circuit diagram is an LED that can be turned on and 
off with a GPIO output. The orange wire is the connection from 
the GPIO output. This then goes through a 2200 resistor to limit 
the current draw to a safe level. This current flows through the 
positive leg of the LED and then back to ground. We need nine 
LEDsforthis project. 
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Wire up buttons 

The second circuit we need is a 
push button. The purple wire goes to a 
GPIO input. There is a lOKQ pull down 
resistor to ground, which represents 
a logical 0. When the push button is 
pressed, the 3.3V supply representing a 
logical 1 is connected to the purple wire. 
The electricity takes this path because it 
has less resistance than the path to 
ground. We need two buttons for record 
and undo, and then as many buttons as 
you like for samples (three drum samples 
are provided). 


Download samples 

Create a few folder for the 
project called pisampler. Then download 
and unzipthe sounds: 


mkdir pisampler 
I cd pisampler 

wget http://liamfraser.co.uk/lud/ 
pisampler/sounds .zip 
I unzip sounds.zip 


There will now be a folder called sounds 
with some samples in. The file format for 
samples is .wav audio, Microsoft PCM, 
16 bit stereo 44100 Hz. Mono will work 
too. Any samples can be converted to this 
format with Audacity by exporting them as 
a.wavfile. 


Full COdG listing (Cont. on next page) 


step 04 


import RPi.GPIO as GPIO 
import time 
import pygame 
import os 


beat_leds = [2, 3, 4, 17] 
bar_leds ~ [27, 22, 10, 9] 
record_led = 11 
record = 19 
undo = 26 

debounce = 200 # ms 


Step 05 


class Sample (obj ect) : 

def init (self, pin, sound, sampler): 

self sampler = sampler 
self name sound 

self sound pygame. mixer. Sound(os, path join('sounds' , sound)) 
self. pin pin 
GPI0,setup(pin, GPIO. IN) 

GPIO. add_event_detect(self pin, GPIO. RISING, callback self play_btn, 
bouncetime debounce) 


Step 06 


def play_btn(self , channel): 
self. sound play() 
s “ self sampler 
if s. recording: 

s.recording_data[s bar_n][s quantize_n] append({'loop’ : 

' sample ' 


class PiSampler(object): 

def init (self, tempo'80, quantize=64) : 

pygame. mixer. pre_init(44100, -16, 1, 512) 
pygame init() 


s loop_count , 
: self}) 


M Import required libraries 

Create a file called pisampler. 
py in your favourite editor. The first thing 
we need to do is import the required 
libraries and set some configuration 
values. A key option is debounce: the time 
to wait before a button can be pressed 
again to stop accidental presses from 
contact bounce. 

Create a sample class 

We’re going to use a class to 
represent each sample. It's going to need 
a few things: the pin that the sample 
button is connected to, the name of the 
sound file, and a reference to the instance 
of the sampler class. We haven’t created 
the sampler class yet, but the sample 
will need to be able to tell if the sampler is 
recording or not, and have access to the 
data structure that recordings are stored in 
to add itself to it if necessary. 

The other thing that we need to do is set 
the GPIO pin to an input, and add an event 
listener for when the button is pressed. We 
set callback (the function to be executed 
when the button is pressed) to a function 
called self play_btn, which will play a sound 


self quantize = quantize 
self. tempo tempo 
self . recording False 
self . record_next False 

self metronome False 

self.met_low pygame mixer Sound(os. path join(' sounds', 'met_low.wav')) 
self .met_high pygame. mixer. Sound(os. path join( 'sounds ' , 'met_high.wav’)) 
self . met_low . set_volume (0 . 4) 
self . met_high . set_volume (0 . 4) 

self samples [] 

self . recording_data = [] 
for i in range (0, 4): 
bar_arr [] 

for i in range(0, quantize): 
bar_arr append([]) 

self recording_data . append(bar_arr) 

GPIO. setmode (GPIO BCM) 

fof pin in beat_leds ■ bar_leds ■ [record_led] : 

GPI0.setup(pin, GPIO OUT) 

GPIO. setup (record, GPIO. IN) 

GPIO . add_event_detect (record , GPIO .RISING , 

callback self . record_next_loop, 
bouncetime debounce) 





ELECTRONICS 


Full 


step 06 


Step 0 


Step 08 


Step 13 


Step 11 


code listing (Cont.) 

GPIO.setup(undo, GPIO IN) 

GPIO add_event_detect (undo , GPIO , RISING , 

callback=self undo_previous_loop, 
bouncetime debounce) 


and add it to the recording data if we are recording. 
It will become abundantly clear how this works once 
we've written the sampler class. Note that the GPIO 
event handler passes the pin that the event handler was 
triggered on, hence the channel variable that is present 
but never used. 


Sproperty 
def tennpo(self) : 

return self._tempo 

©tempo. setter 
def tertipo(self , tempo) : 
self._tempo tempo 
self seconds_per_beat = 60.0 / tempo 

self quantize_per_beat self quantize / 4 

self quantize_seconds = self .seconds_per_beat / self quantize. 

per_beat 


def add (self, sample): 

self samples , append (sample) 

©property 

def recording(self) : 

return self ._recording 

©recording. setter 
def recording(self, value): 
self ._recording = value 
GPIO output (record_led, value) 


The sampler init method 

Here’s the start of the sampler class. The 
last value in the Pygame mixer init is the buffer size. 
You might need to increase this to 1024 or higher if 
you have audio dropouts. We create some variables 
to store recording state. Metronome sounds are then 
added and their volume lowered. We also create a list 
to hold our samples in. 

We create nested arrays to represent recorded 
sample presses. There is an array for each bar. Each 
bar has an array for each possible quantize value. 
The default value of 64 gives us 64 possible places to 
store a sample hit per bar. 

Finally, we set up the LED pins, and the pins for the 
record and undo buttons. 


The tempo property 

\Jw The tempo variable is actually a property with a 
custom setter. This means when a value is assigned, it 
does a custom action. In our case, we need to calculate 
how often we need to check for recorded notes to play 
in the main loop that we’ll write later. 


def record_next_loop(self, channel): 
self record_next = True 


def play_recording(self) : 

for sample_dict in self recording_data[self bar_n][self 
quantize_n] : 

if sample_dict['loop'] !“ self loop_count: 
sannple_dict[ ' sample ' ] . sound play () 


Helper functions 

There are a few helper functions in the 
class. One of them simply adds a sample to the list of 
samples. Another sets a variable to trigger recording at 
the start of the next loop. There is also afunotion which 
turns the red LED on when the recording variable is set 
to true. Now we'll jump forward and take care of the 
main loop towards the end of the full code listing. 


def undo_previous_loop(self, channel): 
if len(self last_recorded_loop) = 0: 
print "No previous loop to undo" 
return 

print "Undoing previous loop" 

loop self last_recorded_loop pop() 

foi bar in self . recording_data: 
for quantize in bar: 
removes [] 
for sample in quantize: 

if sampleC’loop'] loop: 
removes append(sample) 

for sample in removes: 

quantize remove (sample) 

def do_leds(self, leds, n): 
count - 0 
foi led in leds: 
if count == n: 

GPIO output (led, True) 
else: 


Start the main loop 

The main loop doesn’t actually have to do 
any work at all to play sounds, as that’s done by the 
GPIO event handlers. The main loop is used to play the 
metronome, update the state about which bar/beat/ 
quantize we are currently on, update the LEDs and deal 
with recording if necessary. 

Before the loop, we create variables to track the 
state. The last recorded loop is a list that we will use 
as a stack. A stack is a last in/first out data structure, 
allowing us to undo recordings multiple times by 
removing each sample that was recorded when the 
loop count was the value on the top of the stack. 

If we’re at the start of a new beat then we use a 
function called do_leds that we haven’t created yet. 
As the LEDs work in the same way (a block of four LEDs 
where only one is turned on), we can use the same 
function twice and Just pass a different set of pins, 
and the index of the LED we want to turn on. We then 
call the do_metronome function which will play the 
appropriate metronome sound. 

We then do some recording logic which starts 
recording if we should be recording, and stops 
recording if we have just been recording, adding the 
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loop number to the [ast_recorded_[oop stack. We 
increment the loop count after doing this. 

^ 1^3111 loop continued 

This code is at the indentation level after 
the “while True:” statement. After dealing with the 
recording logic, we need to play any notes that have 
been previously recorded. We’ll work out how to do 
that later on. After that, we can sleep until the next 
quantize change is due. Once this happens, we have to 
do logic that deals with the quantize and any related 
variables such as the beat or bar if necessary, either 
incrementingthem or resettingthem if necessary. 

Lighting LEDs 

I I The LED code is simple, it simply goes through 
each pin in the list you provide it with and lights up the 
appropriate LED, ensuring that all of the others are 
turned off 

The metronome 

The metronome simply plays a high tone on the 
first beat or a lower tone on the remaining beats if the 
metronome variable is set to true. 

B The recording code 

Looking back at the sample class we created at 
the start, you can see that if recording is enabled, and 
a note is pressed, then we add a dictionary to the list 
of samples for the current bar at the current quantize 
point. The dictionary contains a reference to the 
sample so that it can be played, and also the loop that 
it was added on so that it can be removed if necessary. 
The code for playing and undoing recordings can be 
seen below. 

Note that we directly play the sound rather than 
using the btn_play function so that we don’t trigger the 
recording logic when playing recorded sounds. 

The pop function in undo_previous_loop removes 
the last thing that was added to the stack, which will 
be the loop count. We then go through every possible 
recording data point and remove anything recorded on 
the loop we want to remove. 

M Finishing it off 

To finish it off, we need to add a main function 
where we load some samples in and then start the 
main loop. Remember that you need to run the code 
with sudo python2 pisampler.py because we need sudo 
to access the GRID. Happy jamming! 

1 C Possible improvements 

There are a number of improvements that 
could be made to the sampler. Here are a few to get 
you started: 

• A button to turn the metronomeon and off 
• The ability to time stretch samples (such as chords) 
to fit with the tempo 

• The ability to pitch shift samples on the fly 
• Using a shift register to use less pins when lighting 
the LEDs, allowing more inputs 
• The ability to save recorded beats so that they can 
be loaded and played back 


Full code listing (Cont.) 


step 11 


Step 12 


GPIO. output (led, False) 
count += 1 


def do_metronoftie(self) : 
if not self metronome: 
return 

if self beat_n = 0: 

self met_high playO 
else: 

self .nnet_low play() 


Step 09 


[] 


def run (self): 

self . loop_count = 0 
self, last_recorded_loop 
self,bar_n = 0 
self,beat_n = 0 
self quantize_beat_n = 0 
self ,quantize_n = 0 


while True: 

if self quantize_beat_n = 0: 

self do_leds (beat_leds , self , beat_n) 
self do_leds(bar_leds, self bar_n) 
self do_metronome() 


0: 


Step 10 


Step 14 


if self .quantize_n = 0 and self.bar_n 
if self record_next: 

self. recording = True 
self,record_next False 
elif self. recording: 

self recording = False 

self . last_recorded_loop append (self . loop_count) 

self loop_count += 1 

self play_recording() 

time sleep(self quantize_seconds) 

if self quantize_beat_n -- self quantize_per_beat - 1: 
self quantize_beat_n = 0 
self beat_n += 1 
else: 

self quantize_beat_n += 1 

if self quantize_n = self quantize - 1: 

self quantize_n = 0 
else: 

self quantize_n += 1 

if self beat_n = 4: 
self beat_n = 0 
self bar_n += 1 
ii self bar_n = 4: 
self bar_n = 0 

if name = ” main ": 

sampler = PiSampler(tempo-140) 
sampler add(Sample(05, 'kick01.wav', sampler)) 
sampler, add(Sample(06, 'snare01.wav', sampler)) 
sampler, add(Sample(13, 'clhat01.wav', sampler)) 
sampler. metronome = True 
sampler run() 
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Transform your Pi into a 
micro oscillosa>pe 

Prepare to turn your Raspberry Pi into a fully functional 
micro oscilloscope, logic analyser and waveform 
generator with the BitScope Micro 


f Requiring no external power 
source, the BitScope Micro is 
also water resistant 


The Raspberry Pi has been used in a plethora of 
applications in hardware, software and some 
quite unbelievable combinations of the two. From 
record-breaking space flights to automated bartending 
devices and much more, there are thousands of Raspberry Pi 
projects that, over the last two and a half years, have shown 
what a capable little Linux box this is. 

The BitScope Micro is certainly no exception and when you 
couple it with your Raspberry Pi you have a very powerful, 
pocket-sized oscilloscope that also features a whole 
host of other functionalities, such as a waveform and clock 
generator as well as a spectrum and logic analyser. Best of 
all though, the whole setup (including the Raspberry Pi itself) 
comes in at well under £150. 

Requiring no external power source, the BitScope Micro is 
also water resistant and so is perfect for either home or lab 
use. It is fully configurable and user programmable in Python, 
C++ and more, and can even continuously stream data to disk. 



Grab your BitScope 

If you have not already done so, you need to go and 
order your shiny new BitScope Micro (directly from BitScope 
or from one of their worldwide retailers). If you are serious 
about electronics then you need a good oscilloscope, so it 
is truly worth every pennyl Once it arrives, you should be 
greeted with the neatly packaged box pictured above. 
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Open up the box 

Once you have received your BitScope Micro and 
opened up the box for the first time you should find all of the 
pictured items inside (if you get any extras, then it is obviously 
your lucky day). The main contents are the BitScope Micro 
itself (with mini USB cable preattached) and a set of ten 
test clip grabbers. There is also a variety of documentation 
containing a large amount of product info and guidance. 


Update your Raspberry Pi 

As with almost every project you undertake on the 
Raspberry Pi, it pays dividends to make sure your operating 
system is updated to the latest stable version, as this can save a 
lot of hassle further down the line. To do this, open an LXTerminal 
session and then type: 

I sudo apt-get update 
sudo apt-get upgrade -y 

Then wait patiently for the upgrade process to complete. 
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M Locate the BitScope Software 

Now your Raspberry Pi is all up to date you need 
to acquire the BitScope DSO (digital storage oscilloscope) 
software. This is not yet available as a Raspbian package, 
but it is very easy to install anyway using the downloadable 
DEB file. Visit www.bitscope.com/pi and click on the 
Download link at the top. 



Download the software 

The previous step should have brought you to the 
BitScope Downloads page. From here you need to download 
the top item in the list, BitScope DSO 2.7 (beta), and save it to 
the /home/pi directory on your Raspberry Pi so you know where 
to find it later. On some browsers the file will automatically 
download to the /home/pi/Downloads directory. 

Install the software 

Now we have downloaded the package, the easiest 
way to install the software is to open an LXTerminal session 
and then runthe following code... 

I sudo dpkg -i bitscope-dso_2.7.EA17H_arnnhf.deb 
...or the equivalent version for newer software. You should see 
lines of output as the installation progresses. The BitScope 
DSO software then appears in the main menu under Other. 


Overclockyour Raspberry Pi (optional) 

The BitScope software will run fine on a Raspberry Pi with 
default settings, however it can be a bit slow to respond. Open 
an LXTerminal session and type sudo raspi-config. In the menu, 
select option 7 Overclock. Olick OK on the following screen and on 
the next one select Turbo. Click OK and then you should see some 
code run. Once this completes press OK and then you are brought 
back to the main raspi-config window. Select Finish at the bottom 
right, and then select Yes to reboot your Raspberry Pi. 


Above The BitScope 
Micro comes 
complete with 
test clip grabbers 
and a whole lot of 
documentation 


Multiple 

platform 

support 



One of the best 
things aboutthe 
BitScope Micro 
(as well as its 
big brother, the 
BitScope BS10U) 
is that it’s capable 
of running on a Pi 
and on any Linux, 
Windows or Mac 
OSXdevice with 
a USB port. The 
graphical Ul is 
identical on each 
of these devices so 
it’s easy to switch 
between them. The 
BitScope Micro 
should also work 
with smartphones 
capable of USBon- 
the-go connections, 
but there is no 
software available to 
take advantage 
of this yet. 




Hardware 

upgrades 



One of the best 
things aboutthe 
BitScope Micro 
is that it runs on 
exactly the same 
software as the 
more capable 
hardware in the 
range. This means 
if at some point in 
the future you feel 
the BitScope Micro 
is not enough for 
your needs, you can 
quickly and easily 
upgradeto better 
hardware with no 
hassle, and no need 
to learn any new 
software! 



Overclocking- parttwo 

Overclocking can sometimes cause instability on your 
Raspberry Pi or an inability to boot at all. If this happens, you 
can press and hold the Shift key on your keyboard once you 
reach the above splash screen to boot into recovery mode. 
You can then re-do step 7 at a lower overclock setting and 
repeat until you find the highest stable setting. 


Plug in the BitScope 

Now that the software has been successfully 
installed on your Raspberry Pi, we can get started with the 
BitScope. If you are using a Model A or B Raspberry Pi without 
a USB hub then I would recommend turning the Raspberry Pi 
off before attaching the BitScope or it may crash. The B-l- 
should be fine with plug and play. 


[ Overclock can 
sometinnes 
cause instability 


Familiarise yourself with the software 

I I The image on page 33 shows the screen layout of the 
BitScope DSO software. It is fairly intuitive, and is similar to 
other physical or virtual oscilloscopes. The largest part is the 
main display window. To the top-left is the trigger window (this 
changes to wave control if selected). Under the main window you 
have the analog input channels and various trim adjustments. 



Load the BitScope DSO 

Now you can navigate to the BitScope DSO software in 
the menu. This should load a splash screen with two options 
- POWER and SETUP. Click POWER and then OK on the pop- 
up information box. After a minute or less, the BitScope DSO 
main screen will load and you should see some lights on the 
BitScope start to flash. 


Familiarise yourself with pinout 

The image above shows the BitScope Micro pinout 
diagram. There are a total of ten pins with two of them being 
ground pins (GND). The remaining eight pins can be configured 
as logic pins and four of them also have different functions - 
L4 is also a waveform generator (AWG), L5 is a clock generator, 
(CLK) and L7 and L6 relate to CHA and CHB respectively. 
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B Perform a sample experiment 

The easiest way to test whether or not your BitScope is 
working correctly is to connect one of the test clip grabbers to 
the analog input CHA on the BitScope. Connect the other end 
to physical pin two on your Raspberry Pi and adjust the scale of 
the y axis to 2V/div. You should then see an output in the main 
window of around five volts. 



M Use different waveforms 

The BitScope can generate its own waveforms. Connect 
a female-to-female Jumper cable between CHA and L4 (AWG). 
On the right-hand side of the DSO interface, select Wave and 
then a wave should appear in the main screen. Change the x 
axis to lOOus/Div and the y axis to 500mV/Div. Right-click on 
the yellow OFFSET button and select MEDIAN. The wave should 
now fill the main window as in the above screenshot. You can 
adjust various parameters of the waveform in the wave control 
panel top-left and can also change to step (square) or ramp 
(saw-tooth) waves instead of tone (sinusoidal). 


Experimenting with your body 

Another interesting (but fairly simple) thing to try is 
measuring electrical signals from your body. Set the vertical 
axis to IV/Divand horizontal to 20ms/Div. Then plug in one of the 
probes to CHA, pull back the grabber end and touch it with your 
finger. You should then see a sine wave on the screen. Bizarrely, 
this wave is actually radio waves emitted by your mains electrical 


wiring which are then being picked up by your body (which is 
acting as an antenna). This is why the wavelength of the signal 
you see is approximately 50 to 60 Hz. 


Programmingyour BitScope 

1^/ The BitScope DSO and other available software (BitScope 
Logic and BitScope Chart) are very powerful applications for a lot 
of experimentation. However, in some more complex monitoring 
environments they may not offer enough flexibility. The good 
news is that you can program the BitScope in C/C-H-, Python or 
Pascal usingtheir programming API. 



Furtherexperimentstotry 

I m This tutorial has shown only a small fraction of what the 
BitScope Micro is capable of As seen in the above image it can 
also be used as a spectrum analyser along with a whole host of 
other functionality. Perhaps for your next experiment you could 
measure the resistance of your body by comparing the voltage 
drop across your body with that of a known resistor. Or you could 
try probing your 12C or SPI connections to see how they work. If you 
ever run out of ideas, then why not visit the BitScope website and 
start experimentingfurther! 


Above The 
experiment uses 
yourbodyasan 
antenna to pickup 
radio emissions from 
your house 


Mains 

electrical 

frequency 



We looked at a signal 
from your body 
caused by radio 
emissions from the 
mains power supply 
in your home. In 
Europethe mains 
frequency is 50 Hz 
and typically with 
a voltage of 230 or 
thereabouts. In USA 
and some parts 
of Asia, the mains 
frequency is 60 Hz 
with atypical voltage 
of 110. Most modern 
electrical equipment 
istherefore capable 
of operating at either 
voltage or frequency. 
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Left For the next version, Dan may add a palm 
button for a hierarchical menu structure to 
navigate the functions on each finger-button 


Popper buttons Beneath 

the fingers are small metal discs that 
can be activated just by a touch. Each 
button has been given a new function 


Power pack As well as the Model 

A+, the USB charger used to power 
the Pi can be mounted on the glove by 
sliding it inside on the palm side 


Camera module This has been] 

embedded intothefabricontheback 
of the glove, so photos can be taken by 
raisingahand and touchinga button 


Raspberry Pi Usingthe Model 

A+, the Ras Pi could be mounted on 
the back of the glove. The old CATS 
cables were replaced with fewer wires 


Below Now he’s done the social media {see 
issue 148) and the home help modules, Dan 
will make a start on the fitness module 




Components list 

■ Raspberry Pi Model A+ 

■ Raspberry Pi camera module 

■ 5 Short cables 

■ 5 Popper buttons 

■ USB mobile phone battery 

■ USB Wi-Fi dongle 

■ Energenie add-on board 

■ Golf glove 


HOW I MADE: PI GLOVE 2 


How I made: 

Pi Glove 2 

^ Check out Dan Aldred's new home help module 


What physical modifications have 
you made since we last spoke? 

The glove is more portable - 
previously, the Raspberry Pi was in the 
wearer’s pocket and you had the long 
CAT5 cables attached the glove. This has 
all been stripped back and several steps 
enabled this. Firstly, was the use of fabric 
clothes poppers to replace the tactile 
switches. These are metal and when one 
makes contact with a ground popper on 
the thumb, it creates the circuit. It has 
meant that the same functionality is 
achieved with five wires as opposed to 
the previous ten wires. Secondly, I have 
moved from a B+ model to the A+ model, 
which has meant that the Raspberry Pi 
is now small enough to be mounted on to 
the glove itself. Now the wires only need 
to run from the fingertip to the wrist. The 
camera module is also embedded within 
the glove. The lens is exposed through the 
glove but the rest of the camera is now 
housed within the fabric of the glove. You 
have to be a little bit more careful when 
you take the glove off, but the overall 
pay-off is that the glove is now lighter 
and more compact. The power comes 
from a small USB mobile phone charger 
which gives about six hours running time, 
depending on how much you use it for. 

What new functions does the rebuilt 
glove have? 

It was always the plan to develop the Pi 
Glove with ‘modules’ for various uses, 
starting with home assistance. Imagine 
if you did or maybe do struggle with a 
disability and you wake up in the night 
- the Pi Glove now enables you to check 
the time, which is read out, and a light 
can be turned on with a simple finger 
movement. If required, an emergency 
text can be sent to a carer, family 
member or the provider of other medical 
assistance. The fourth button enables 
the Pi camera, which takes a picture of 
a sign, for example. OCR is then used to 
recognise and store the text, which is 
then read back to you. 

I decided to add the Pi camera around 
the back of the hand area - this linked 


in well, enabling a more mobile use of 
the camera; it can now be positioned 
in a direction that the user wants, is 
more accessible and you could even 
take a selfie! The main reason for this 
change was to enable ‘on the fly’ optical 
character recognition. I installed a 
Python OCR library and, combining 
this with the image taken from the Pi 
camera, the software can identify the 
text within the picture. This text is then 
fed back to the console and easy-Speak 
reads out the text. I tried various file 
formats - JPG seemed to work well. 
Also, changing the picture to black and 
white to pick up detail and differentiate 
between the text, had improved results. 
There were issues with it not identifying 
text in low light, and also if the text was 
the wrong way round or upside down. 
Finally, changing the saturation and 
increasing the sharpness produced 
usable results. 

The emergency text on the second 
button makes use of Twilio, the web- 
based communication API, which 
enables the user to send a pre-written 
message requesting assistance. This 
could be adopted by others, such as 
the police or fire brigade, for use in 
dangerous situations. The current time 
is also added to the text. 

To turn the lights on I used an add-on 
board by Energenie. Once installed you 
can use it to control up to four simple 
Energenie radio-controlled sockets 
independently, using a small program. 
The add-on board connects directly to 
the GPIO, which can be controlled as 
either input or output lines under your 
software control. A Python library is also 
available to program the sockets. I simply 
mapped the ‘on’ state to the click of the 
button and it turned the light on - from 
yourfingertipsi 


Are you currently developing any new 
modules for thefuture? 

The current module I am working on is 
fitness-related and will allow the wearer 
to take their heart rate, change their 
music and upload the details of a run 
to their chosen social media site. This 
will be on the fly with no need to stop 
running or whatever sporting activity 
you are doing. Just touch the buttons 
and your workout music changes, or your 
heart rate is read and then converted to 
a string and read back to you through 
your headphones. I find that current 
apps on phones and watches disrupt 
your workout - I don’t want to have 
to stop running to check my pulse or 
change the music. 

I was looking at the idea of linking the 
glove functionally to a smartphone but 
this, I feel, would be moving away from 
the original aim, which was to remove 
the cumbersomeness of the phone - 
having to unlock it, load an app, wait for 
the camera to prepare itself The glove 
enables you to click and go. 

What would you like to do for the third 
iteration of Project New York? 

I was introduced to the Micro Python 
Pyboard (micropython.org/live), which 
has a range of features built in and is 
smaller, making it more suitable as a 
wearable component. The Micro Python 
board is a small electronic circuit board 
that runs Micro Python on the bare 
metal, and gives you a low-level Python 
operating system that can be used to 
take control of all kinds of different 
electronic projects. 

The battery size is also an area that 
could be reduced - I am looking into this. 
The smaller that all these components 
are, the more natural the glove will feel 
when it’s being worn. 


[ The camera takes a picture of a 
sign. OCR recognises and stores 
the text, which is read back to you 



DanAldredis 

a curriculum Leader 
for Computing and IT 
at a comprehensive 
schooLandthe 
Lead co-ordinator 
for Computing 
At School. As 
a Raspberry Pi 
Certified Educator, 
Dan promotesthe 
use of the Pi in 
education and as a 
toolfor learning. 

Like it? 

To learn more about 
the redesigned 
Raspberry Pi Glove 
and the current 
home help module, 
check out Dan’s 
YouTube video (bit. 
ly/1HVQTYA)and 
the project write-up 
(bit.ly/19xgQyC). 

Further 

reading 

If you’re interested 
in setting up 
optical character 
recognition foryour 
own sign-reading 
Python projects, 
check out Dan’s 
guide over at 
TeCoEd (Teaching 
Computing 
Education): 
tecoed.co.uk/ 
python-ocr.html. 
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Assemble a Minecraft 
power move glove 

Create a piece of wearable tech with power moves assigned to 
each button to enhance your Mineaaft game 



Many of you will be avid fans of the game Minecraft. In 

schools it is fast becoming a motivational teaching and 
learning tool, useful in areas such as programming, creating 
logic gates and setting up a network. 

This project is framed around creating a simple networked 
Minecraft game where one player chases the other and 
tries to hit the block they are standing on. The real hack is 
programming a ‘power glove’ that enables you to assign power 
moves to each button. These powers can then be deployed 
and used to slow down the other player and get yourself out 
of sticky situations - check out the video at bit.ly/ICQSmHS! 
The real beauty of this hack is that you can then create and 
customise your own power moves. The possibilities are 
endless, limited only by your imagination. If you're confident 
with GPIO pins and settingup buttons, jump straight to Step 8. 


Update the Raspberry Pi 

1 This project is designed for the Raspberry Pi 2 which 
requires the updated operating system, although it is compatible 
with the Raspberry Pi B+too. First ensure that the software is up 
to date - open the LXTerminal type: 

I sudo apt-get update 
sudo apt-get dist-upgrade 
sudo apt-get install raspberrypi-ui-mods 

Connect a button to the Raspberry Pi 

Take one of the buttons and conneot a wire to each 
contact, then take the other two ends and connect to the Pi. You 
may find this easier using a female-to-female connector. To set 
up a test button, use GPIO pin 17 - this is physical pin number 11 
on the board. The other wire connects to a ground pin, shown by a 
minus sign (the pin above GPIO pin 17 is a ground pin). 






What youll need 

■ Raspberry Pi 2 

■ 4 X 6mm tactile buttons 

■ Female-to-female jerky 

■ Terminal blocks 

■ A glove 

■ Router 

- 2x CATS cables 


MU 
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Test that the button works 

Use this test code to ensure the button is functioning 
correctly. Once it is, the same setup method can be used 
throughout this project. To ensure the buttons are responsive, 
use the pull-up resistor with the code GPiO.PUD_UP - this will 
ensure that multiple touches aren’t registered on each button. 
Using Python 2.8, type in the code below, then save and run. If 
working correctly, it will return the message 'Button works’. 

import RPi.GPIO as GPIO 


PiGlovePowerMoves . py 

import time 

from mcpi import minecraft 

me = minecraft. Minecraft. create(“192. 168. 1.211”) 
#Peplace with the other players IP address 

import PPi.GPIO as GPIO 



GPIO.setmode(GPIO.BCM) 


#Set up the GPIO Pins 
GPIO. setmode (GPIO BCM) 


GPIO cleanupO 

GPIO setup(17, GPIO IN, GPIO PUD_UP) 
True: 

GPIO input(17) == 0: 

“Button works” 



M Create a power move 

Now to create you r first power move. The glove and code 
are structured in such a way that once the basic code template is 
set up, you can create your own power moves and assign them to 
each button, keeping both your ideas and your gameplay fresh. 
The first power move you will program enables you to place a wall 
of TNT between you and the playertryingto catch you. They have 
a choice to go around the wall or blow it up, but it will slow them 
down. In a new Python window, type the code below and save the 
program into the home folder: 

import time 
Fi rewall 0 : 

mc.postToChat(“Firewall Placed”) 

TNT = 46,1 

X, y, z me player, getPosO 
mc.setBlocks(x-6, y, z+2, x+6, y+10, z+3, TNT) 
time sleep(10) 


True: 

FirewallO 


Open Minecraft 

The updated version of the Raspbian OS comes with 
Minecraft pre-installed, it can be found under Menu>Games 
- so load it up. If you have used the Minecraft: Pi Edition before 
you will be aware that it runs better in a smaller-sized window, 
so don’t make it full screen. You may prefer to adjust and arrange 
each window side-by-side to enable you to view both the Python 
code and the Minecraftgame at the same time. 


#Sets the pin to high 
GPIO. cleanupO 

GPI0.setup(17, GPIO IN, GPIO.PUD_UP) 

#11 on the BOARD GREEN Firewall 
GPI0.setup(18, GPIO IN, GPIO PUD_UP) 

#12 on the BOARD BROWN Lava 
GPI0.setup(9, GPIO. IN, GPIO.PUD_UP) 

#21 on the BOARD BLUE Mega Jump 
GPI0.setup(4, GPIO. IN, GPIO.PUD_UP) 

#7 on the BOARD ORANGE Puddle 
GPIO.setwarnings(False) #switch off other ports 

#Builds a wall of TNT which if the player hits will explode 
c-;* FirewallO: 

me postToChat(“Firewall Placed”) 

TNT = 46,1 

X, y, z - me player. getPosO 
mc.setBlocks(x-6, y, z+2, x-r6, y+10, z+3, TNT) 
time.sleep(l) 

#Lays Lava to slow down the other player 
no'- Lay_LavaO: 

Lava 10 
check = 1 

me postToChat(“Lava Deployed”) 
check : 
time.sleep(0.2 ) 

X, y, z me. player. getPosO 
mc.setBlock(x-l, y, z. Lava) 
check = 0 

#Peforms a Mega Jump to lose players 
u-; Mega_JumpO: 
time.sleep(0.1) 
me postToChat(“Mega-Jump”) 

X, y, z = me player. getPosO 
me player, setPos(x, y+15, z) 
time.sleep(l) 

#Creates a Puddle to slow down your player 
:'■■■ Mega_Water_PuddleO: 

me postToChat(“Mega Water Puddle”) 
time.sleep(0.2) 

WATER = 9 

X, y, z me player, getPosO 
me setBlocks(x-5, y, z-4, x-1, y, z+4, WATER) 
time.sleep(l) 


GPIO pins 



GPIO pins area 
physical interface 
between the Pi and 
theoutside world. 
Atthe simplest 
level, you can 
thinkofthemas 
switches that you 
can turn on or off 
(input) orthatthe 
Pi can turn on or off 
(output). The GPIO. 
BCM option means 
thatyou are referring 
to the pins bythe 
“Broadcom SOC 
channel” number. 
GPIO.BOARD 
specifiesthatyou 
are referringto the 
pins bythe number 
of the pin andthe 
plug-the numbers 
printed on the board. 
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IP address 


Most home 
networks will use 
IPaddressesthat 
start with 192.168.1 
and then a number 
upto 255. An old 
routerwill assign 
these IP addresses 
automatioally. If 
the router has Wi-Fi 
then players can 
also connectto 
multiplayer usinga 
USB Wi-Fi dongle; 
you are settingup 
a LAN (Local Area 
Network). 


Engage the firewall 

Start a new Minecraft game, then go to the Python 
program and press F5 to run it. You may need to press the 
Tab key to release the mouse from the Minecraft window. The 
program will place a 12 x 10 wall of TNT behind the player every 
ten seconds -you can blow them up but the Pi might lag. 

Assign the power move to the button 

\Jw Now you have a working button and a power move, you 
can combine these two together. Basically, when you press the 
button the power move will deploy. Once this is working you can 
then set up the other three buttons with the same method. Open 
a new Python window and type in the code below - save the file 
in the home folder. Start a Minecraft game as shown in Step 6 
and then run the new program. Every time you press the button 
you will place a TNT firewall. 


import time 

from mcpi import minecraft 

me - minecraft. Minecraft. createO 

import RPi.GPIO as GPIO 

GPIO setmode (GPIO.BCM) 

GPIO setup(17, GPIO IN, GPIO PUD_UP) 


FirewallO : 

me . postToChat(“Firewall Placed”) 

TNT = 46,1 

X, y, z me. player. getPosO 
mc,setBlocks(x-6, y, z-2, x+6, y+10, z-1, TNT) 


True: 

GPIO input(17) == 0: 
FirewallO 


Below If you want to 
getfancy, try using 
the popper buttons 
that Dan added to 
his Pi Glove 2 project 


SstiJpfiFther buttons 

Once you have one button working the next step is 
to set up the other three using the same method from Step 2. 
Take the button and connect the two wires to either side. At this 
point you can add all three buttons and test them individually 
for connectivity. Connect each set of button wires to the GPIO 17 
and run the firewall program. If the firewall power move builds 
on each click of the button, the connections and buttons are 
working and you’re ready to attach the buttons to the glove. 



Create the glove 

Take your glove and attach the four 
buttons to the fingers on the glove. There are a 
number of ways to do this: glue the button 
on, sewthem in, stick them with double- 
sided tape - the choice is up to 
you. Wires can be hidden or on 
display, depending on your 
preferences and how you 
wantthe glove to look. 


W Connect the wires 

Now you are ready to connect the wires to the Raspberry 
Pi to enable all four power moves to be used. Take one end of 
each wire and connect them to the respective pins, as shown 
below. The other end of the wire is placed into aground pin. Note 
that the RPi.GPIO pin numbering system is used here rather 
than the physical pin number on the board - for example, GPIO 
pin 17 is physical pin number 11. The following pins are used: 

GPIO 17, pin 11 on the board 
GPIO 18, pin 12 on the board 
GPIO 9, pin 21 on the board 
GPIO 4, pin 7 on the board 


Set the network up 

I I TointeractwithotherplayersIntheMnecraftworldyouwill 
need to set up a networked multiplayer game. This is simple and 
can be achieved using an old router. Oonnect each Raspberry Pi 
via an ethernet cable to the router and then back to the ethernet 
port on each Raspberry Pi. Turn on the router and wait about 
30 seconds for the IP addresses to be assigned. Now load up 
Minecraftand one of the players will start a new game. 



Run the game! 

After the game has loaded, the other connected player 
will see an option to “connect to a multiplayer game”, usually 
called Steve. The player selects this option and the networked 
game will begin. You will be able to see two ‘Steves’ and the 
Minecraft chat will inform you that ‘Steve has joined the game’. 
Open Python and the glove code, press F5 to run and you will be 
able to see the power moves being deployed . 



Interact in another player’s world 

You’ll notice under the current setup that if the Pi Glove 
is connected to the game and you use one of your power moves, 
it will only appear in your Minecraft worki and not in the other 
players. This isn’t great, as the power move is supposed to stop 
the other player! To resolve this, find the IP address of the other 
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Raspberry Pi, then enter this IP address into this line of code: me 
= minecraft.Minecraft.create( ). For example, mc=minecraft. 
Minecraft.create(“192.168.2.234”), filling the empty brackets 
with the IP address of the other Raspberry Pi within your game. 
Remember that this is the IP address of the other player’s 
Raspberry Pi and not your IP address. 

M Find your IP addresses 

To find the IP address of a Raspberry Pi, load the LX 
terminal, type ipconfig and press Enter - the address will 
be displayed on the line that begins int addr:. This is the 
number that you enter into the me = minecraft.Minecraft. 
create(“192.168.2.234”). Remember on the Glove Raspberry Pi to 
enter the IPaddress of the other player’s Raspberry Pi, notyours. 


Run both programs 

No game would be complete without some healthy 
competition and strategy. A second program is deployed by the 
other player on the network which tracks and registers if they 
catch or hit you. The program checks the block that they have hit 
and compares ittothe player’s location. 



Test for hits 

To check if the other player has hit you, run the second 
program on the Raspberry Pi of the player who is doing the 
chasing. The program basically finds the other ‘glove’ players 
current position and stores it in a variable. It then compares 
the position that you hit with your sword, recording and storing 
this too. The program then compares the values, if they match 
then you have hit the other player and have won the game. If 
not, get ready for a tirade of power moves. Note that in order to 
monitor where the other player is, you must set the code line 
mcl = minecraft.Minecraft.create( ) to the IP address of the 
Glove Raspberry Pi; for example, mcl = minecraft.Minecraft. 
create(“192.168.1.251”). 


The program compares the values, 
if they match then you have hit 
the other player and have won the 
game. If not, then get ready for a 
tirade of power moves 

PiGlovePowerMoves . py 

#Main code to run 


lava_check = 0 

me. postToChat(“Minecraft Power Glove Enabled”) 
True: 

GPIO input(17) == 0: 

FirewallO 

GPIO input(18) == 0: #needs to stop 
Lay_LavaO 

#GPI0. output (18, GPIO. LOW) 

GPIO input(9) == 0: 

Mega_Jump() 

GPIO input (4) == 0: 

Mega_Water_Puddle() 


“Error” 

YouWereHit.py 

import time 

from mepi import minecraft 

mcl - minecraft.Minecraft create(“192. 168. 1.245”) 


me minecraft. Minecraft. createO 
me postToChat(“###Here I come”) 
Hit = 1 


Hit -- 1: 


Game on 

Now you are ready to play, check again that the IP 
addresses are set for the other Raspberry Pi and not your 
own. Build a new Minecraft world and start a new game on the 
Raspberry Pi with the player who is chasing. When loaded, the 
glove player joins the multiplayer game - this will be called Steve 
(see Step 11). When loaded, you should see both players in the 
world. Then run the ‘Pi Glove power moves’ program, and on the 
other Pi run the ‘You hit me program’. Don’t forget to set the IP 
addresses to each other Raspberry Pi. 

Once set up, you can modify the power moves, use different 
blocks and add new moves. You could create a timer and a 
scoring system to track which player can survive the longest. If 
you are feeling adventurous, you may want to make another 
Power Glove, one for each player. 


stood_x, stood_y, stood_z = mcl player, getTilePos() 
time, sleep(^) 

blockHits = me, events. pollBlockHitsO 
blockHits: 

blockHit in blockHits: 

stood_z blockHit pos z and stood_y blockHit pos.y+1 
me postToChat(“I got you”) 
time.sleep(2) 

me postToChat(“###GAME OVER###”) 
time,sleep(l) 

Hit = 0 

me postToChat(“###Restart Hit Code”) 





Buid a complex LED matrix 

LED matrix display systems find use everywhere from gaudy kebab 
shops to impressive steampunk-styled systems 


Driving LEDs in an efficient fashion is a science of its own. 

The common availability of single-board computers has put 
the necessary technology within reach of everyone. 

When dealing with LED displays, two different systems 
must be considered. We will focus on traditional matrix- 
based systems made up of one or more LEDs. Their 
affordable nature makes them ideally suited to classic display 
applications: they communicate currency prices, provide 
stock-brokers with updates from the trading floor and have 
even been used as basic displays for primitive oscilloscopes. 

Finally, we will also provide you with an overview of 
electronic basics. This tutorial is a bit more advanced than the 
ones we’ve featured up until now, and it’s also worth noting 
that we’re going to be programming with C rather than Python. 
Follow along using the code listing annos. 


Think about LEDs 

Standalone LEDs are primitive - they light up onoe 
current flows through them. Driving a few LEDs is as easy as 
connecting them to GPIO pins along with a resistor. Sadly, this 
method becomes wasteful once more than a few of them get 
involved - driving 1 6 diodes ties up 1 6 pins. 

Arrange your diodes 

Methods were devised to reduce the number of pins 
needed. Matrix-based systems are resilient to individual 
diode failures, and provide a pin-to-LED ratio of n={n/2)''2. The 
following steps assume a 16x16 LED matrix which is made 
up according to Figure A. Since LEDs permit current in only 
one direction, you can enable a single LED by bringing the 
corresponding pins high and low. 






BUILD A COMPLEX LED MATRIX 


Our LED model has 
a total of 32 inputs, 
which overwhelms 
older versions 



Above The extended version of this schematic is inside FileSilo.co.uk 
- just sign in and head to the issue #1 51 page 


Full code listing 


step 12 


#include "CceinniapGpio . h" 
#include <unistd.h> 
#include <stdio.h> 


step 07 


#define 

PINAO 

2 // 

3 

#define 

PINAl 

3 // 

5 

#define 

PINA2 

4 // 

7 

#define 

PINAS 

14// 

8 

#define 

PINCSO 

17// 

11 

#define 

PINCSl 

18// 

12 

#define 

PINDO 

23// 

16 

#define 

PINDl 

24// 

18 

#define 

PIND2 

10// 

19 

#define 

PIND3 

9 // 

21 

#define 

PIND4 

25// 

22 

#define 

PIND5 

11// 

23 

#define 

PIND6 

8 // 

24 

#define 

PIND7 

7 // 

26 


V 1 " setAddress( ^ _which, mmapGpio* _where) 

{ 

(_which&l ) 

{ 

_where->wr itePinHigh ( PINAO ) ; 

} 


_where->writePinLow( PINAO) ; 
(_which&2 ) 


_where->wr itePinHigh (PINAl) ; 


Harness the MUX 

Our LED module has a total of 32 inputs, which 
overwhelms older versions of the RPi. The first way to restrict 
their number comes in the shape of the 74HC238, a component 
described as a 3-to-8 line decoder/demultiplexer. Its function is 
described in the Figure B image on the next page. 

M Separate concerns 

Chip two goes by the name of 74HC244, which is 
described as an octal buffer with tri-state capability. Tri-State 
outputs can physically disconnect themselves from the bus 
line. This permits you to tie their outputs together without 
fear of short circuits. As long as all but one chip are in tri-state 
mode, no current can flow between high and low output pins. 

Round them up 

Four GPIO pins control the currently-enabled ‘line’ 
of the display. Three pins configure the address which is to 
be emitted, while the signal emitted from the fourth pin is 
connected to the activity inputs. This ensures that but one 1C 
is active. The 74HC244 ensures that but one of the two groups 
is active at any given time. 


Configure the pins 

We used a library from Flussam Al-Flertani’s 
Flertaville blog (hertaville.eom/2014/07/07/rpimmapgpio). 
The first step involves setting output functions. As the GPIOs 
are set to outputs, the tri-state feature might connect the 
internal state to the output pins of the 1C. This could lead to 
internal shorting if the output is not turned off. 


Step 08 


{ 

_where“>writePinLow( PINAl) ; 

} 


(_which&4 ) 

{ 

_where->wr itePinHigh (PINA2 ) ; 

} 

{ 

_where->writePinLow(PINA2 ) ; 

} 

(_which&8 ) 

{ 

_where'>writePinHigh( PINAS) ; 

} 

{ 

_where->writePinLow(PINA3) ; 

} 


vr ’ safelySetRow( _which, nmapGpio* _where) 

{ 

_where->writePinHigh(PINCSO) ; 
_where->writePinHigh(PINCSl) ; 

(_which“0 ) 

{ 

_where->writePinLow(PINCSO) ; 

} 

{ 
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PowertheMUX 

Create a convenience function taking an address 
ranging from zero to 15. It is converted into pin outputs for our 
3-to-8-demu[tip[exer. The effect of this is that all but one of 
the sixteen rows is to be supplied with energy. 


Full code listing 

_where ->writePinLow(PINCSl ) ; 


step 08 


Step 11 


setData( 
(_which&l ) 


_which, mmapGpio* _where) 


_where">writePinHigh(PINDO ) ; 

_where->writePinLow(PINDO ) ; 
(_which&2 ) 

_where->writePinHigh(PINDl ) ; 

_where ->writePinLow(PINDl ) ; 
(_which&4 ) 

_where">writePinHigh(PIND2 ) ; 


Select a row 

In the 74HC244, we first disable both units and 
proceed to turning on the one which is needed. This sequence 
prevents ghosting during the switching process. 


A A Do the main loop 

The outer part of the loop consists of logic that 
manages the addressing of the individual rows. Our program 
must flash the individual LED groups one after another using 
the building blocks described in the next step. 

^A Complete the loop 

Writing out data is accomplished in a sequence of three 
commands. We select the row, configure the column and then 
write out the data bits that are to be displayed. A small pause 
is observed in order to give the LEDs some time to ‘burn into’ 
the viewer’s eyes. 



Above Digital LED matrices like this one give you far more control over 
each individual ‘pixel’ in the display 


{ 

_where->writePinIiOw(PIND2 ) ; 

} 


(_which&8) 

{ 

_where ->wr itePinHigh ( PIND3 ) ; 

} 

{ 

_where ->writePinIiOw(PIND3 ) ; 


} 

{ 

} 


(_which&16) 

_where->writePinHigh(PIND4 ) ; 


_where">writePinLow(PIND4 ) ; 
_which&32 ) 

_where">writePinHigh(PIND5 ) ; 

_where->writePinLow(PIND5 ) ; 
_which&64 ) 

_where->writePinHigh(PIND6 ) ; 

_where->writePinLow(PIND6) ; 
_which&128) 

_where->wr itePinHigh (PIND7 ) ; 


LED 

stripes 



Two versions of LED 
strips are offered. 
‘Primitive’ ones are 
based on analogue 
technology. In it, an 
entire strip of diodes 
has the colour set 
by thethree input 
pins. Systems such 
as the mega-display 
shown in the left- 
hand image require 
the use of the 
digital version. They 
are based on the 
concept of the shift 
register. Your system 
inputs individual 
colour values which 
are then pushed on 
along the strip. 






BUILD A COMPLEX LED MATRIX 



Above This is the full schematic of the LED matrix that we’re working 
with here (you can also view it at its full size on FileSIlo) 


Full code listing 

{ 

_where->writePinLow(PIND7 ) ; 

} 


step 06 


main ( ' ) 

mmapGpio rpiGpio; 

//Set outputs 

rpiGpio . setPinDir ( PINAO , mmapGpio ; ^ OUTPUT ) ; 
rpiGpio . setPinDir ( PINAl , mmapGpio ; ^ OUTPUT ) ; 
rpiGpio . setPinDir ( PINA2 , mmapGpio ; ^ OUTPUT ) ; 
rpiGpio . setPinDir ( PINAS , mmapGpio - OUTPUT ) ; 
//TURN OFF ASAPl 

rpiGpio . setPinDir ( PINCSO , mmapGpio ^ ^ OUTPUT ) ; 
rpiGpio.writePinHigh(PINCSO) ; 

//TURN OFF ASAPl 

rpiGpio . setPinDir ( PINGS 1 , mmapGpio : ■ OUTPUT ) ; 
rpiGpio. writePinHigh( PINGS 1) ; 
rpiGpio . setPinDir ( PINDO , mmapGpio ; ^ OUTPUT ) ; 
rpiGpio . setPinDir ( PINDl , mmapGpio ; ^ OUTPUT ) ; 
rpiGpio . setPinDir ( PIND2 , mmapGpio - OUTPUT ) ; 
rpiGpio . setPinDir ( PIND3 , mmapGpio - OUTPUT ) ; 
rpiGpio . setPinDir ( PIND4 , mmapGpio : ^ OUTPUT ) ; 
rpiGpio . setPinDir ( PIND5 , mmapGpio ^ ^ OUTPUT ) ; 
rpiGpio . setPinDir ( PIND6 , mmapGpio : - OUTPUT ) ; 
rpiGpio . setPinDir ( PIND7 , mmapGpio : - OUTPUT ) ; 


Energy control 

I I LEDs light up if current flows through them. SetData pulls 
the pins of the 74HC244 low to ensure that the energy supplied 
from the 74HC238 can flow through the diode. 

Avoid GPIO trouble 

The Raspberry Pi Foundation has a tendency to change 
the layout of the expansion header regularly, a habit which 
professional manufacturers of process computers abhor. 
It’s recommended to handle the mapping between pins and 
functions via a set of defines. Our code is optimised for a 
Rev2 Raspberry Pi with a ‘short’ header - 40-pin variants will 
require readjustments making sure the physical pin numbers 
correspond to the logical GPIO numbers. 

B Add example data 

Test the code by setting the datastore to a value of your 
choice. Setting 64 to all fields will disable one row in each part 
of the display. 

M Kick it off 

Check all connections between the planar and the 
single-board computer, and proceed to starting the compiled 
app. Don’t forget to use the sudo command - direct memory 
access is restricted to root in order to prevent apps from 
causing havoc in the physical memory. Users are accustomed 
to this, so requiring them to put a sudo in front of the 
command doesn’t cause concern. 


1C Notice a flicker 

Sharp-eyed readers will notice an occasional flicker 
where one line appears brighter than the others. This is 
caused by the stalling of the program - if the kernel does 
other work, the switching routine can’t run. We could solve 
this problem by using a real-time Linux kernel. 


dataStore [ 2 ] [ 16 ] ; 


Step 13 


Step 09 


( j=0; j<2; j-t+) 

{ 

( k=0;k<16;k;+) 

{ 


datastore [ j ] [k]=64 ; 

} 

} 


blockCounter=0 ; 
rowCounter=0 ; 

( 1 ) 

{ 

blockGounter-i -i- ; 

(blockGounter==16 ) 

{ 

( rowGounter==0 ) 

{ 

blockGounter=0 ; 
rowGounter=l ; 

} 


step 10 


{ 

blockGounter=0 ; 
rowGounter=0 ; 

} 

} 

saf elySetRow ( rowGounter , & rpiGpio ) ; 
setAddress (blockGounter, &rpiGpio) ; 
setData( datastore [rcRnXHounter] [blockGounter] , 
usleep( 50 ) ; 


/rpiGpio) ; 


} 







ELECTRONICS 


Add gesture (x>ntrol to 
your Raspberry Pi 

Hover is an impressive add-on board for your Raspberry Pi that 
allows you to easily add touch and gesture control to any project 



w 

What yoi/l need 

■ Raspberry Pi 

■ Hover 

■ Breadboard 

■ Male to female 
jumper cables 

■ Speaker or headphones 


People often ask what the best way is for them to 
get started with Raspberry Pi. Obviously this does 
depend on the individual user and what they want 
to achieve and get out of any project, but in a more 
general sense it’s often the hardware projects 
that win out for getting to grips with it. They teach 
a variety of skills (including programming, circuit 
building, soldering, hardware design and much 
more) and are also varied enough to both keep 
beginners interested and allow them to work out 
for themselves exactly what aspect they love 
best. Even a seasoned professional will get a 
serious kick out of a bit of physical computing and 


automation! This is one of the unique features of the 
Pi compared to traditional “black box" computers; 
you can break out of the usual boundaries and 
interface with everyday objects like never before. 

One of the most important aspects of a hardware 
project is often the user input mechanism, and 
as technology is refined we see new and more 
intuitive ways to accomplish this task. Gesture 
and touch control is now present in a large 
number of consumer devices and even the biggest 
technophobes are starting to embrace the ease of 
this technology. It is time to bring your Raspberry Pi 
projects into the 21st century with Hover! 


ADD GESTURE CONTROL TO YOUR RASPBERRY PI 



The physical pins you 
should be using on 
the Raspberry Pi are 
1,3, 5, 6, 16and18 


Get the gear! 

I The Hover add on board is available to purchase direct 
from Hover (http://www.hoverlabs.co/#shop) for $39 (£25), 
however this will ship from Northern America and therefore if you 
are based in the UK or Europe it will likely be quicker and cheaper 
to order from one of the other retailers listed via the above link. 
The added benefit of ordering from a retailer is that if you need 
any of the other items you can likely get those at the same time! 

Hover will work perfectly with any Raspberry Pi, including both 
the new plus versions and the older models - just make sure 
your system is fully up to date with: 

i sudo apt-get update 
sudo apt-get upgrade 


fyy Update GPIO and I2C 

When making use of GPIO and I2C (or any other 
interfacing technique on the Raspberry Pi) it is always good 
practice to update to the very latest software versions possible. 
Newer versions typically have bug fixes and additional futures 
which can come in very handy. GPIO and the RPi.GPIO Python 
library are installed by default on Raspbian, but you may need to 
enable 120 if you haven’t already. This is a fairly standard process 
and has been covered many ti mes so we won’t go i nto it here. We 
would, however, highly recommend the brilliant 120 setup tutorial 
from Adafruit (https://learn.adafruit.com/adafruits-raspberry- 
pi-lesson-4-gpio-setup/configuring-i2c). 



Set up the hardware 

Make sure your Raspberry Pi is powered down and 
not connected to power before starting this step, to avoid any 
unnecessary damage to your Raspberry Pi. Pick up your Hover, 
breadboard and wires and connect the as shown in the Fritzing 
diagram. The physical pins you should be using on the Raspberry 
Pi are 1, 3, 5, 6, 16 and 18. Whilst a Model B Pi is shown, this will 
be the same connection on a Model A, B, A+ or B+ of any revision. 
Once completely set up like the image, reconnect the power cord 
and open an LXTerminal session. 


M Check the connection 

Hover connects to the Raspberry Pi through the 
I2C interface located on the main 26 or 40 pin GPIO bank 
(depending on which version of the Raspberry Pi you are 
using). There is a very easy way to check if your Raspberry Pi is 
correctly connected to Hover using the simple command line 
120 tools. Issue the following command: 

I sudo i2cdetect -y 1 


If you see 42 in the response then you are successfully 
connected to Hover! 


AboveYoucantap 
the Hover or swipe 
in four directions 
just above it 


Plenty of 
platforms 



The Hover board 
has intelligent on- 
board level shifting, 
meaning that it can 
be used with either 
3.3V or 5V Logic 
levels which means 
it can be used with 
pretty much any 
microcontroller your 
heart desires. There 
are connection 
examples and 
oode snippets 
available for 
Arduino,Sparkcore 
and PCduinoon 
the Hover website 
(hoverlabs.com) and 
these oan also be 
adapted to suit other 
devices fairly easily. 

If you decideto 
create your own 
example with 
another device then 
why not submit a pull 
requestto the Hover 
GitHub {github.com/ 
jonco91)ifyouare 
happy to share! 



ELECTRONICS 



Above This MGC3130 
chip works as the 3D 
tracking and gesture 
controller 


Why 

Python? 



Python is extremely 
useful for beginners 
due to its easy-to- 
understand syntax, 
fairly prose-like 
formation and the 
flexibility and ease 
of acquiring existing 
software libraries to 
help your projects. 

It is also the official 
programming 
language of the 
Raspberry Pi and is 
therefore very well 
supported withinthe 
community. That is 
not to say that Hover 
will not work with 
other programming 
languages; simply 
that the creators of 
Hover have not yet 
released any code 
libraries in other 
languages. 



Usings Rev 1 Pi? 

In the code, we have passed an option “-y 1” which tells 
the operating system which I2C bus to look at (there are two on 
the BCM2835 processor on the Pi). The first revision Raspberry 
Pi (the one that initially launched in February 2012 with 256MB 
of RAM) made use of I2C bus 0, whereas all other versions of 
the Raspberry Pi since have used I2C bus 1. So the above code 
would ohangeto: 

I sudo i2cdetect -y 0 

And you should expect the same output (42) as in step 7. 
Additionally you will need to edit line 27 of the Hover_library. 
py file, changing bus = smbus.SMBus(l) to bus = smbus. 
SMBus(O). A patch that automatically detects the Raspberry 
Pi version and makes this change for you has been submitted, 
but not yet acoepted into the master branch so this may not be 
necessary in future versions. 


Download the sample code 

Now you have everything hooked up oorreotly and 
your Raspberry Pi is fully up to date, it is time to get the 
Plover Python library, which makes using the board from 
Python scripts extremely easy. You can get this using the 
following command: 

I git clone https://github.com/jonco91/hover_ 
raspberrypi.git 

This should download a folder oalled hover_raspberrypi to 
your /home/pi direotory oontaining all of the files needed for 
this article. Alternatively you can download the zip file from 
https://github.com/jonco91/hover_raspberrypi/archive/ 
master.zip. 

Run the example file 

The current Hover library is simply a Python file 
with all of the necessary functions included within it, rather 
than an installable package (however, this may change in 
the future). In order to use the functions contained within 
the Hover_library.py script discussed above, it is therefore 
necessary to make sure that the Hover_library.py script is 
located in the same folder as any soript you have written that 
makes useof any of the Hover functions. In a terminal session, 
navigate to the folder containing the Hover_example.py file 
and run it using: 

I sudo python Hover_example.py 

The Hover board will initialise and you will then see a message 
“Hover is ready”, meaningyou are good to go. 





ADD GESTURE CONTROL TO YOUR RASPBERRY PI 


Investigate the output 

Once you have completed step 7, if you touch the 
Hover board or make gestures above it you will begin to see 
output in the terminal which is a bunch of Os and Is and then 
a description of what it has seen - right swipe, north tap, 
etc. The way the Hover works is that it can sense any one of 
nine different actions and these are sent to the Raspberry Pi 
over I2C as an 8-bit binary value. The first three bits describe 
whether it was a touch or gesture event and the remaining five 
bits describe the specific type or direction of the event. The 
exact breakdown can be seen in the code listingtothe right. 

Enable 3.5mm audio 

Grab your speakers and plugthem in to the 3.5mm jack 
plug on the Raspberry Pi. You will then need to route audio to 
the 3.5mm Jack using the following command (you can skip this 
step if you are using an HDMI display, which has in-built audio): 

I sudo amixer cset nunnid=3 1 


Make a drum machine 

In the hover_raspberrypi folder is another folder called 
examples that contains code and sounds to turn Hover into a 
drum machine! Navigate to the hover_raspberrypi directory 
and then copy the Hover_library.py file into the examples folder 
by using: 

I cp Hover_library.py examples 

You can then move into the examples folder and run the Hover_ 
drum. py file using: 

I cd examples 

sudo python Hover_drum.py 

Make some gestures and taps on and around Hover and you 
will have your own basic drum machine! 

Create your own responses 

The great thing about having a Python library available is 
that it is easy to integrate this device into any of your existing or 
future projects. The code shown is all you need to get started 
with Hover. You will see that on line 15 and onwards there are 
comments saying “code for... goes here”. Essentially all you need 
to do is insert the actions you want to occur on the particular 
event mentioned in the comment and you will be up and 
running. .. it really is that easy! 


Full code listing 

import time 

from Hover_library import Hover 

hover = Hover(address=0x42, ts=23, reset=24) 

try: 

while True: 

# Check if hover is ready to send gesture 

# or touch events 

if (hover. getStatusO == 0): 

# Read i2c data and print the type of 

# gesture or touch event 
message = hover. getEvent() 
type(message) 

if (message == “01000010”) : 

# code for west touch goes here 
elif (message == “01010000”): 

# code for centre touch goes here 
elif (message == “01001000”): 

# code for east touch goes here 
elif (message == “01000001”): 

# code for south touch goes here 
elif (message == “01000100”): 

# code for north touch goes here 
elif (message == “00100010”): 

# code for swipe right goes here 
elif (message == “00100100”): 

# code for swipe left goes here 
elif (message == “00110000”): 

# code for swipe down goes here 
elif (message == “00101000”): 

# code for swipe up goes here 

# Release the ts pin until Hover is 

# ready to send the next event 
hover. setReleaseO 

time. sleep(0. 0008) #sleep for 1ms 

except Keyboardinterrupt : 
print “Exiting. . . ” 
hover. end() 

except : 

print “Something has gone wrong...” 
hover. end() 

Other project ideas 

Most of you are probably now wracking your brains for 
projects you could use Hover in, but let’s face it - pretty much 
any project that requires physical interaction would be made 
better with touch and gesture control. If you think it is cool but 
are lacking inspiration, we recommend looking at the projects 
section of the Hover website at http://www.hoverlabs. 
co/projects, where there are projects by the creators and 
community alike. If you make something cool, be sure to send 
us the pictures! 








Where are the 
hoverboards? 



Did you come 
here Looking for 
information on how 
to build your space 
age transportation 
device? We can’t 
help you with 
that, but we don’t 
wantto leave you 
disappointed! 
Hoverboards were 
first popularised as 
afictional personal 
transportation 
method in the 1989 
film BackToThe 
Future Part II and 
tookthe appearance 
of a levitating 
skateboard with no 
wheels. 25 years 
later and it seems 
we might be getting 
close to turningthis 
dream into a reality. 
Hendo Hoverboards 
have created a 
$10,000 hoverboard 
which uses a 
principle similar 
tothatof maglev 
trains to generate lift 
(kck.st/ZMd9AA), 
and more recently 
Ryan Craven has 
created a much 
cheaper alternative 
usingfourleaf 
blowers and some 
other cheap parts 
(mrhoverboard. 
com/about). 



Chords You can play chords by 
manipulating three thumbsticksat 
once - how you move them affects 
the sound of the notes in the chord 


Thumbsticks Push forward/ 

backward to switch between triangles 
and reverse sawtooth waves or push 
left/rightto affect the oscillators 


Joytone Note Map 


Isomorphic AlLthe chords and 

scales you can play have the same 
geometric shape, no matter what key 
you’re playingthem in 


Hexagonal rid The Joytone 

uses a hexagonal layout forthe notes 
like electronic musical instruments 
such as Rainboard or apps like Musix 


Components list 


Raspberry Pi Model B 
Cypress PSoC 4 
Arduino Micro 
57 Xbox 360 thumbsticks 
57 NeoPixel Diffused 8mm 
Through-Hole LEDs (Adafruit) 

8 16-channel analogue multiplexers 
5 16mm Illuminated Pushbuttons 
(Adafruit) 

200mm SoftPot Membrane 
Potentiometer 


Above (inset) Gettingto know 
the musical distances between 
adjacent thumbsticks is the key 
to learningto playthe Joytone 

Right There’s a marathon lab 
session behind this six-note 
demo unit that Sharpies and 
Glanzman presented at the CIS 
Senior Design Fair 





HOW I MADE: JOYTONE 



^ What inspired the Joytone? 

I David Sharpies The Joytone is an 
I expressive isomorphic musical 
instrument which came out of my 
frustration trying to learn to play 
musical instruments. 1 was trying to 
teach myself piano and was wondering 
why there are white and black keys 
- it makes things so much harder. 1 
learned a bit of music theory and came 
to realise that a major scale is just a 
well-defined musical structure; the gaps 
between the notes in a major scale are 
the same regardless of which major 
scale it is. But, because there are white 
and black keys on a piano, you can play 
a C major scale just by running up all 
the white notes. If you want to play a C# 
major scale you have to throw in a bunch 
of black keys. It’s hard to remember and 
you have to build up muscle memory. So 
one of the goals with this project is to 
build an instrument that doesn’t have 
that bias based on the keys - so it’s 
isomorphic; that’s what that means. 

And you’re using analogue thumbsticks? 

David Glanzman They’re Xbox joysticks... 
Sharpies That’s the second big goal of 
the project. When 1 was researching this, 
1 noticed there were some instruments 
that had these isomorphic keyboards - 
a grid of hexagons - but the issue was 
that they were just buttons, they didn’t 
have the same richness and depth as an 
actual musical instrument. When you’re 
playing a guitar there are a million ways 
to affect the sound - how hard you’re 
pushing on the string, how hard you 
pluck it, where on the fret you’re holding 
it, if you bend the string or not - and you 
can get all these rich sonic qualities. So 
we wanted to make it isomorphic and 
we wanted to make it expressive. We 
used these thumbsticks because you get 
two channels of analogue control in this 
familiar little interface. One axis changes 
the waveform of the synthesised sound 
from a triangle wave (has a pure, bell-like 
quality) to a reverse sawtooth wave (has 
a buzzy, bright sound, like a trumpet). 
There are two oscillators creating each 


How I made: 
Joytone 

Reinventing the keyboard with a grid of joysticks 


note and if you push the thumbstick to 
the left, those oscillators are exactly 
in tune, making a very soft sound. If 
you push it all the way to the right then 
they’re offset by a couple of hertz, which 
makes a wide, rich sound. Then the 
amount that you rotate the joystick gives 
the volume. So you have two and a half 
dimensions of control there, which adds 
some depth to the sound. 

What is the role of the Raspberry Pi? 

Sharpies There’s a two-brain system 
going on - we have the Raspberry Pi and 
then we have the Cypress PSoC 4. The 
Cypress PSoCAdoesallthe heavy lifting 
with the data reading. 

Glanzman It does all the measurements 
for the joysticks. It’s got ADCs in it that 
convert analogue to digital, and then 
basically looks at each axis for each 
joystick in sequence, records it, and 
then waits for the Raspberry Pi to ask it 
for data values for each of the joysticks. 
Sharpies There’s 57 thumbsticks and 
each one has two analogue channels, 
so that’s 114 analogue channels total. 
So what we did was we had eight 
16-channel multiplexers hooked up 
to the PSoC and then the PSoC sends 
a signal to all of them that says ‘give 
me channel one’. Then it reads the 
eight channels, and then it says ‘give 
me channel two’ and it reads the eight 
channel twos. After it does that for all 
16 channels it then has this full bank 
of current data. The Raspberry Pi 
periodically says ‘give me all your most 
recent data’, so the PSoC forwards the 
data to the Raspberry Pi, which then 
does a little bit of processing in Python 
and then sends commands to PureData, 
which is our synthesiser program. 

What’s the Arduino component doing? 

Sharpies Each thumbstick also has 
an RGB LED in its hexagonal cell, and 
our intention was to use these to show 
which nodes are in key or out of key. We 
also wanted to guide the user through a 
scale - or even a song, showing the next 
note that they’re supposed to play - but 


we ran into some technical difficulties. 
The ideal setup for this is that you 
daisy-chain all these lights in a big line 
and then hook them up to an Arduino 
Micro, which is really good at controlling 
these specific lights from Adafruit, and 
then it can just push all of this data down 
the line and you should just be able to 
put whatever colours you want on each 
light individually. But we had some 
problems with the signal and could only 
get about fourlights to behave. 

is it easy to learn to play the Joytone? 

Sharpies The barrier to entry is much 
lower. It’s funny, when we first got it 
working, David was playing with it, 
wearing headphones, and he sort of 
stopped talking and was pushing a few 
of the joysticks, like ‘Wait, wait...’, and 
then he just played back Bach. So the key 
to learning it is just learning a little, tiny 
bit about the structures in music theory. 
There’s a shape you can hold your fingers 
in that will play a major chord; once you 
learn that shape, that’s it - that’s how all 
of the Joytone’s major chords are played. 
Glanzman When it comes to learning 
the Joytone, you have to attack musical 
instruction differently than you would 
with another instrument. When you 
learn something like the piano, you 
learn that this is D major, this is F# 
minor - you learn different things 
based on the note, the actual class. 
But with the Joytone, the pitch class 
is totally irrelevant because we hear 
everything in relevant terms, and you 
play everything in relative terms. So to 
learn the instrument, you don’t even 
have to discuss pitch classes - you 
just talk about relative distances. So 
major thirds or minor thirds, fifths, 
fourths - it’s distances between notes 
instead of the actual note values. 
1 think if you phrase musical instruction 
in those terms, in terms that we 
experience music in rather than the 
terms we normally go through to create 
music, it becomes a much more natural 
interface because it’s built on that type of 
instruction, making it simple to learn. 



David 

Sharpies 

isan interaction 
designer and 
graduated from 
the University of 
Pennsylvania’s 
Digital Media Design 
programme 



David 

Glanzman 


isasophomore 
in Computer 
Engineeringat 
the University of 
Pennsylvania. 

David has worked 
on microprocessor 
design, audio 
electronics, medical 
devicesand more 

Like it? 

Interested in 
learning more 
about isomorphic 
instruments? 
Checkout David 
Sharpies’ senior 
design blog: 
davesharpl.es/blog 

Further 

reading 

Here’sthefinal 
demovideo ofthe 
Joytone, comprising 
David Glanzman’s 
virtuoso Bach 
performance: 
bit.ly/lvfXnlw 




Simulate traffic lights 
using your breadboard 

Step into physical connputing and hardware engineering with 
Raspberry Pi and this breadboard-based traffic light simulation 


Even with a platform as cheap, simple and powerful as the 
Raspberry Pi, taking your first foray into the world of physical 
computing and hardware projects can often be a fairly 
daunting experience. There are a number of extra factors to 
consider, and the margin for error can be quite a bit slimmer. 

On the plus side, however, physical computing is perhaps the 
most rewarding way to experiment with computers and coding, 
as it allows you to manipulate tangible items in the physical world 
with the power of code. You’ll learn plenty of essential skills along 
the way, and the thrilling reward of seeing your code manifested 
in a physical action simply can't be beaten. 

One of the best ways to start making use of those GPIO pins 
and get really creative with your Pi later is a simple LED project, 
as it will allow you to see the main GPIO commands in action. 
Now get your Raspberry Pi, LEDs and jumper cables at the ready 
and let’s get started! 


Get the parts 

The parts for required for this tutorial should all be 
available from any reputable electronics dealer such as Maplin, 
CPO or one of the many independent Raspberry Pi retailers. The 
breadboard, LEDs, cables and resistors should cost you around 
£5 to £10 maximum. 

Update your Pi 

Before undertaking any project, regardless of whether 
it is hardware or software based, you should always update 
your Raspberry Pi to ensure you have the most stable software 
versions and latest functionality. This is especially important 
when experimenting with GPIO. You can do this using the 
following commands: 

I sudo apt-get update 
I sudo apt-get upgrade 






SIMULATE TRAFFIC LIGHTS USING YOUR BREADBOARD 





Prepare the hardware 

To begin, build and test a simple circuit to ensure 
everything is working correctly. Grab the breadboard, two 
jumper wires, the red LED, one 330 Ohm resistor and your 
Raspberry Pi, and connect everythingtogether as shown in the 
above image. Ensure your Raspberry Pi is powered off when 
connectingthingstotheGPIO to avoid damage. 

Add some code 

The code below is a simple snippet to test that the 
connection is correct and that the LED is working. Create 
a blank Python script by typing sudo nano test.py at the 
command line and then writing in the code below. Save and exit 
the script by using Ctrl-X and then pressing Yand Enter. You can 
then execute the script by typing sudo python test.py at the 
command line. 

import RPi.GPIO as GPIO 
import time 



Add more code 

In order to simulate a real block of traffic lights, we 
need to run through a sequence of colours. The code below 
achieves this, and the version we've uploaded to FileSilo.co.uk is 
commented throughout so you can understand what it is doing. 
As in step 4, you will need to add this to a Python script to execute 
it, calling it ‘traff iclight.py’ this time instead of 'test.py' as before. 

import RPi.GPIO as GPIO 
import time 

GPIO. setmode(GPIO. BCM) 

Leds = [14,15,18] 

lOi Led in Leds: 

GPIO.setup(Led, GPIO.OLIT) 

GPIO.output(Led, False) 





GPIO. setmode(GPIO. BCM) 

GPI0.setup(l4, GPIO.OUT) 

GPI0.output(14, True) 
time.sleep(10) 
GPI0.output(14, False) 


GPIO.cleanupO 



Connect more LEDs 

For a simulation of an actual traffic lights rig, we 
obviously need to add a green and yellow LED into the 
mix. Grab the LEDs and two more resistors, then connect 
everything together like in the image above, again ensuring 
the Pi is powered off first. 


try: 

while True : 

GPIO.output(Leds[0], True) 
time.sleep(, 'i') 

GPIO.output(Leds[.,], True) 
time.sleep(2) 

GPIO.output(Leds[0], False) 

GPIO.output(Leds[l], False) 

GPI0.output(Leds[2], True) 
time.sleep(,f) 

GPIO.output(Leds[,], True) 

GPIO.output(Leds[i], False) 
time.sleep(2) 

GPIO.output(Leds[l], False) 

except : 

GPIO.cleanupO 

Whereto go next? 

This was Just a very simple introduction to 
experimenting with the GPIO on the Raspberry Pi. It shows how 
easy it is to manipulate things in the physical world with code 
and this is often the best way to learn. Check out the Raspberry 
Pi Foundation resources section for more great ideas - 
raspberrypi.org/resources. 



Ladder 

game 



Once you're up to 
speed with the 
basics of controlling 
LEDs with your Pi, 
why not make a 
game that develops 
that knowledge 
further? One project 
that is particularly 
goodforthisisthe 
ladder game, as 
it involves finely 
controllingthe 
timings and more 
complex loops for 
user interaction. 
Check out projects. 
drogon.net/ 
raspberry-pi/gpio- 
examples/ladder- 
game for a great 
guideto this. 
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Program a Raspberry 
Pi quadcopter 


How do you beat a Raspberry Pi robot? You give it wings. Andy 
Baker shows us how to code our way into the clouds 


The Raspberry Pi is a fantastic project board. Since we love 
a challenge, we set out looking for something to really take 
advantage of its capabilities in the most spectacular way 
possible, something that would really push the limits of our 
hacking and coding skiils. We chose a quadcopter. 

Kits are availabie as ready-to-fly (RTF) if you just want the 
joy of fiight, but where’s the challenge in that? We started 
with an almost-ready-to-fly (ARF) kit - the DJi Fiame 
Wheei F450 - all the hardware, but none of the control 
electronics or software. Many enthusiasts have created 
DiY quadcopters using Arduino microcontrollers, so we 


knew a DiY buiid was possible, but very few, if any, have 
successfully used the Raspberry Pi. 

This articie uses the Python code on the disc as a guide 
through what’s needed to build a quadcopter, metaphorically 
bolting it together so that bytheend,you don’t just understand 
the code but also the interaction with the real-worid to enable 
you to build your own quadcopter with confidence. 

As you read the article, you can follow the corresponding 
code by searching for an equivalent tag comment; for example, 
to find the code related to the ‘# Angles’ section of the article, 
simply search the code for ‘# Angles’. 
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Propulsion Here we’re seeing 

the force from the propellers 





V©CtOrS Propeller force relative to 

GrSVity This term denotes the 

Angl© This is the angle of tilt as 
defined bythe quads sensorsj 

Earth’s axis (horizontal / vertical) 

force of gravity 


a, 


■qx 


a 


q □ 




ag = gravitational acceleration 
aq = quadcopter acceleration 


j- = Cq (reorientated to Earth’s axes) 


□ = angle of tilt derived from 
accel + gyro 


a 


qz 


die 


aqx = tan □ 

Sqy 


for horizontal flight 

9qz ~ 

horizontal accel aqx = g + a 


# Interpreter 

The command interpreter converts a series of commands 
either from a radio control or programmed into the code itself. 
The commands combine the direction and speed compared to 
the horizon that the user want the quadcopter to follow. The 
code converts these commands into a series of targets 
for vertical speed, horizontal speed and yaw speed - any 
command from a pairof joysticks can be broken down into a set 
of these targets. 

# Inputs 

The inputs to the quadcopter come from a series of electronic 
sensors providing information about its movement in the 
air. The main two are an accelerometer which measures 
acceleration force (including gravity) in the three axes of the 
quadcopter, and a gyroscope which measures the angular 
speed with which the quadcopter is pitching {nose/tail up 
and down), rolling (left/right side up and down), and yawing 
(spinning clockwise and anticlockwise around the central axis 
of the quadcopter itself). 

# Axes 

The accelerometer is relative to the orientation of quadcopter 
axes, but the command targets are relative to the Earth’s 
axes - the horizon and gravity. To convert the sensor output 
between the quadcopter axes and the Earth axes needs a little 


Understanding 

quadcopters... 

Although this article focuses on software, a very basic 
background in the hardware from the kit is necessary to 
provide context. 

A quadcopter has four propellers (hence the name) 
pointing upwards to the sky, each attached to its 
own brushless DC motor at one of the four corners of 
(usually) a square frame. Two motors spin clockwise, two 
anticlockwise, to minimise angular momentum of the 
quadcopter in flight. 

Each motor is driven independently by an electronic 
speed controller (ESC). The motors themselves have three 
sets of coils (phases), and the ESCs convert a pulse-width- 
modulation (PWM) control signal from software/hardware 
to the three phase high-current output to drive the motors 
at a speed determined bythe control signal. 

The power for the ESCs and everything else on the 
system comes from a Lithium Polymer battery (LiPo) rated 
at 12V, 3300mA with peak surge current of 100A - herein 
lies the power! 


Above How sensors 
inthequadcopter 
point of view are 
converted to the 
Earth (horizontal/ 
vertical) viewpoint 
to provide 
horizontal motion 
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The angle PID takes the desired tilt 
angle from the horizontal speed PID 
and feedback from the gyro and the 
accelerometer combined to produce 
the tilt angle feedback. This results in 
the required angular speed 


The angular speed PIDtakesthe 
required angle PID out, with feedback 
from the gyro to apply power to the 
motors. This produces the required tilt 
and horizontal movement 


The PID outputs are applied 
appropriately to each propeller ESC 
to effect the ohange defined by the 
proceeding commands 


The yaw PIDs are used to ensure the 
quadcopter doesn’t rotate its Z-axis 
inflight 
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The horizontal speed PIDtakes 
movement commands and feedback 
from integrated gyro sensors to define 
the desired tilt and angle to achieve 
the required speed 


n 


The vertical speed PID directly 
controls the desired rate of climb 
or descent with feedbackfrom 
integrating Z-axis accelerometer data 


Commands from the radio-control 
or programmed route are processed 
and converted into a set of desired 
movements in the X, Y and Z axes 


Above PIDs connecting oommands 
and sensorfeedbackto produce an 
output drivingthe propeller blade 
(E)lectronic (S)peed (C)ontrollers 


trigonometry and knowledge of the tilt angles in pitch and roll 
axes of the quadcopter with respect to the Earth. 

# Angles 

Both the accelerometer and gyro can provide this angle 
information, but both have flaws. 

The accelerometer output can be used to calculate the angle 
by using the Euler algorithm. However, the accelerometer output 
is plagued by noise from the motors/propellers, meaning a single 
reading can be hugely inaccurate; on the plus side, the average 
reading remains accurate overtime. 

In contrast, the gyro output does not suffer from the noise, 
but since it is the angular speed being measured, it needs to be 
integrated over time to find the absolute angle of the quadcopter 
in comparison to the horizon. Rounding errors in the integration 
lead to ever increasing errors overtime, ultimately curtailing the 
maximum length of aflight. 

# Filter 

Although independently they are both flawed, they can be 
merged mathematically such that each compensates for the 
flaws in the other, resulting in a noise-free, long-term accurate 


reading. There are many versions of these mathematical noise/ 
drift filters. The best common one is by Kalman; the one we’ve 
chosen is slightly less accurate, but easier to understand and 
therefore to code; the complementary filter. 

Now with an accurate angle in hand, it’s possible to convert 
accelerometer sensor data to inputs relative to the Earth’s axes 
and work out how fast the quadcopter is moving up, down, left, 
right and forwards and backwards compared to the targets that 
have been set. 

#PIDs 

So we now have a target for what we want the quadcopter to 
do, and an input for what it’s doing, and some motors to close 
the gap between the two; all we need now is a way to join these 
together. A direct mathematical algorithm is nigh on impossible 
-accurate weight of the quadcopter, power per rotation of each 
blade, weight imbalance etc would need to be incorporated 
into the equation. And yet none of these factors is stable; 
during flights (and crashes!), blades get damaged, batteries 
move in the frame, grass/mud/moisture changes the weight 
of the ’copter, humidity and altitude would need to accounted 
for. Hopefully it’s clearthis approach simply won’tfly. 
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r Both the accelerometer and gyro can provide 
the angle information, but both have flaws 


Instead, an estimation method is used with feedback 
from the sensors to fine-tune that estimate. Because the 
estimation/feedback code loop spins at over 100 times 
a second, this approach can react to ‘errors’ very quickly 
indeed, and yet it knows nothing about all the factors which 
it is compensating for - that’s all handled blindly by the 
feedback; this is the PID algorithm. 

It takes the target, subtracts the feedback Input, 
resulting In the error. The error is then processed via 
a Proportional, Integral and a Differential algorithm to produce 
the output. 

# Blender 

The outputs are applied to each ESC in turn: the vertical speed 
output is applied equally to all blades; the pitch rate output is 
split 50/50 subtracting from the front blades and adding to the 
back, producing the pitch. Roll is handled similarly. Yaw too is 
handled in a similar way, but applied to diagonal blades which 
spin in the same direction. 

These ESC-specific outputs are then converted to a PWM 
signal to feed to the hardware ESCs with the updated propeller/ 
motor speeds. 


Code and reality 

In this code, there are nine PIDs in total. In the horizontal plane, 
for both the X and Y axes, the horizontal speed PID converts the 
user-defined desired speed to required horizontal acceleration/ 
angle oftilt; the angles PID then converts this desired tilt angle to 
desired tilt rate which the rotation speed PID converts to changes 
in motors speeds fed to the front/back or left/right motors for 
pitch/roll respectively 

in the vertical direction, a single PID converts the desired rate 
of ascent/descent to the acceleration output applied to each 
plate equally. 

Finally, prevention of yaw (like a spinning top) uses two PIDs 
- one to set the desired angle of yaw, set to 0, and one to set the 
yaw rotation speed. The output of these is fed to the diagonally 
opposing motors which spin in the same direction. 

The most critical of the nine are pitch/roll/yaw stability. 
These ensure that whatever other requirements enforced by 
other PIDs and external factors, the quadcopter is stable in 
achieving those other targets; without this stability, the rest 
of the PIDs cannot work. Pitch is controlled by relative speed 
differences between the front and back propellers; roll by left 
and right differences, and yaw by clockwise/anticlockwise 
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Aquadcopterina 
headwind will drift 
backwards due to the 
force applied by the wind 


differences from the corresponding PIDs’ outputs. The net 
outputs of all three PIDs are then applied to the appropriate 
combination of motors’ PWM channels to set the individual 
pulse widths. 

With stability assured, some level of take-off, hover and 
landing can be achieved using the vertical speed PID. Placing 
the quadcopter on a horizontal surface, set the target to 0.5 m/s 
and off she zooms into the air, while the stability PID ensures that 
the horizontal attitude on take-off is maintained throughout the 
shortflight, hover and landing. 

Up to this stage, the PIDs are independent. But what about 
for horizontal movement target, and suppression of drifting in 
the wind? 

Taking the drift suppression first, a quadcopter in a headwind 
will drift backwards due to the force applied by the wind. To 
compensate, it must tilt nose down at some angle so that some 
of the propellers’ thrust is applied horizontally to counteract the 
wind. In doing so, some of the power keeping the ’copter hovering 
at a fixed height is now battling the wind; unless the overall 
power is increased, the ’copter will start descending. 


Horizontal movement is more complex still. The target 
is to move forwards at say 1 metre per second. Initially the 
requirement is similar to the headwind compensation - nose 
down plus increased power will apply a forward force leading 
to forward acceleration. But once that horizontal speed 
is attained, the quadcopter needs to level off to stop the 
acceleration, but at the same time, friction in the air will slow 
the movement. So there’s a dynamic tilting fore/aft to maintain 
this stable forward velocity. 

Both wind-drift suppression and controlled horizontal 
movement use nested PIDs; the X and Y axes horizontal speed 
PIDs’ outputs are used as the pitch and roll angle PIDs targets; 
their output feeds the pitch and roll rate PIDs to ensure stability 
while meeting those angular targets. The sensor feedback 
ensures that as the desired horizontal speed is approached, the 
horizontal speed PID errors shrink, reducing the targets for the 
angular pitch PID, thus bringingthequadcopters nose back up to 
horizontal again. 

Hopefully it now becomes clearer why accurate angle 
tracking is critical; in the nose-down, headwind example, the 
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PrOp©ll©rS The propellers are set 
diagonally to the x, y axes, and rotate as shown 
to reduce yaw (rotation about the z-axis) 

Ori©nt3tion The overall orientation of the 
quadcopterdepictingfront, back, left and right 
in relation tothe sensor and propeller layouts 

S©nSOrS The quadcopters’ 
sensors report data accordingto 
these x,y and z axes 


input to the vertical speed PID from the sensors is reduced by 
the cosine of the measured angle of 'copter tilt with respect to 
the horizon. 

Similarly, X and Y axis speed PID sensor inputs need 
compensating by pitch and roll angles when comparing target 
speeds against accelerometer readings. 

Experimentation and tuning 

While the code accurately reflects everything we’ve described 
here, there’s one critical set of steps which can only be 
found through live testing: these are the PID gains. For each 
PID running, there is an independent Proportional, Integral 
and Differential gain that can only be found with estimation/ 
experimentation. The results for every quadcopter will be 
different. Luckily there is a relatively safe way to proceed. 

First, find the PWM take-off speed: this is done by sitting 
your quadcopter on the ground and slowly increasing the 
PWM value until she starts looking light-footed - for your 
expert, this was about the 1590us pulse width (or lOOOus 
+ 590us, as shown in the code). 

Next, sorting out the stability PIDs - assuming your 
quadcopter is square and its balance is roughly central, 
then the result of pitch tuning also applies to yaw 
tuning. For pitch tuning, disable two diagonally opposed 
motors and rest these on a surface - the quadcopter sits 


horizontal in between. Power up the dangling motors’ 
PWM to just under take-off speed (1550us pulse width in 
our expert’s case). Does the quad rock manically, wobble 
in some pretence of control, self-right when nudged, or do 
nothing? Tweak the P gain accordingly. Once P gain is good, 
add a touch of I gain - this will ensure return to 0 as well as 
stability. D gain is optional, but adds firmness and crisp 
response. Tapping a D-gain stable quad is like knocking on 
a table - it doesn’t move. 

Vertical speed PID can be guesstimated. 1590us is taking 
off: desired take-off speed is 0.5m/s so a P gain of 100 is 
okay. No I or D gain needed. 

With that a real take-off, hover and landing are safe, which 
is good as these are the only way to tune the directional PIDs. 
Just be cautious here - excessive gains lead to quadcopters 
slamming into walls or performing somersaults in mid-air 
before powering themselves into the ground. Best executed 
outside in a large open field/garden/park where the ground is 
soft after overnight rain! 

There isn’t a shortcut to this, so just accept there will be 
crashes and damage and enjoy the carnage as best you can! 

Assuming all the above has gone to plan, then you have a 
quadcopter that takes off, hovers and lands even in breezy 
conditions. Next step is to add a remote control, but that’s for 
another article... 


Above The 
orientation of 
the quadcopter 
compared to the 
direction of travel, 
the rotation of the 
propellers and 
the axes used in 
the code 
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Build your own 
games console 


Raspberry Pi 

hacking projects 

Get the inside story on how to replicate the greatest 
Raspberry Pi hardware hacks 


Simulate a 
spaceship launch 




HOLGA 

120 




Reinvent a 
classic camera 


Activate 
Project Jarvis 


148 



ROJECTS 


Play an AR light 


gun game 


tim . 


that get us excited and make us want to learn more about 
electronics, engineering and programming. 

Over the next few pages we’re going to introduce you to 
some of the greatest Raspberry Pi hacks we’ve discovered. 
Projects where vintage hardware has been torn apart and 
the components repurposed into something amazing, or 
where the hardware has been puzzled over, fiddled with, 
and brought back to life after years spent in a garage. These 
hacks inspire us, with each maker striking the right balance 
between passion, skill and virtuosity, and we hope they 
inspire you too. Read on as we hear how you can launch a 
satellite from a bedroom spaceship, transform an analogue 
camera into a digital one, make a classic Apple Pi and more. 


There are now over five million Raspberry Pi models out in 
the wild, and some of the things that you, the Raspberry 
Pi community, have made with them truly are wild. From 
elegantly crafted scripts that chain together a series of web 
services to homebrew Rube Goldberg machines, they are as 
creative as they are diverse. And through the crowd of new 
projects bubbling up online every day, if there’s one word that’s 
guaranteed to get everyone’s attention then it’s the word ‘hack’. 

But what exactly is a hack? Well, for the purposes of this 
feature, we decided that a hack has to have some sort of 
hardware base. It’s the kind of project where you take one 
device and, with a little Raspberry Pi magic, transform it into 
something wholly new and original. These are the projects 
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Create a robot 
alarm clock 


Retrofit a 
NES console 


Upcycle an 
old radio 
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battery grip big enough to fit my Raspberry Pi 
and a battery, so it went from there. 

“The battery grip holds two batteries. Once 
I’d stripped out the battery compartment, I set 


capable of poweringthe Pi for about four hours. 

“Making it wireless was a case of plugging 
in a USB Wi-Fi adapter. A few lines of Perl later 
and I was able to poll the camera with gphoto2. 


David has been 
making projects for 
the Raspberry Pi 
since the earlydays. 


Above 

Read up on the full build 


Camera Pi 

Power up a regular point-and-shoot DSLR camera 


Maker Profile 
Dave Hunt 

Photographer 
and maker 


Dave Hunt is well known to Raspberry Pi 
fans, and here he’s back with his Camera Pi. 

“I needed to transmit photos to an iPad 
as they were taken,” explains Dave, “but the 
commercial solutions were £500. 1 had a broken 


“The next task was to fit 
a camera battery and DC-DC 
converter inside. I was able to use part of the ill 
removed internals of the grip, and before long h 
I had a slot to insert a camera battery into. It’s jL 




Find out more: 


about filing down all the mounting holes inside pull the new files off and send them via FTP to process and check out Dave’s 


davidhunt.ie 


the grip so I could get the Raspberry Pi inside. ShutterSnitch on my iPad.” 


video at bit.ly/IBxEMbC 


Pi Telephone 

Revive a ringing phane with C# circuit 
wizardry and valtage manipulatian 



Stuart Johnson is bringing a classic GPO 746 handset 
back to life, and while the project isn’t yet complete, 
he has finished the lion’s share of it. 

“I took out the main circuit board inside the phone 
and squeezed the Raspberry Pi in there,” says Stuart. 
“I was then faced with two challenges - the biggest 
one was getting the bell to ring. I found a solution by 
raising the voltage to 19 volts and dropping it down to 
5 for the Ras Pi using a very small DC-DC converter 
(the OKI-78SR), with the rest then being used for the 
bell. I was surprised by how well it worked. 

“The bell is using one of the I/O ports, and there’s an 
available C# library (raspberry-sharp-io) which lets 
you monitor and controlthose ports. So I linked oneof 
the I/Os to the pulse dial and connected 
another to a relay using 
transistors. Then with the 
software I put in a timer to 
measure the pulse clicks. I 
managed to write some 
code to time those 
pulse clicks and 
determine the 
number 
dialled." 


Maker Profile 


Stuart 

Johnson 


Managing 

directar 


Stuart runs 
Logic Ethos, an 
IT company in 
Southampton 
providing network 
services and cloud 
computing help 
to developers. 


Find out more: 

logicethos.com 




Car Computer 

Ours was gaad, but Derek Knaggs really 
has built the real deal 

Remember the car computer that we made 
earlier? Well Derek Knagg already beat us to it, and 
he’s embedded the display in his dashboard and 
extended the setup to include screens for the rear 
passenger seats too. 

“I removed the DVD player, which was a standard 
Ford head unit,” explains Derek, “and then 
purchased a head unit from Xtrons. It’s designed 
for the Ford Focus so it was a straight swap. The 
Xtrons radio has an S-Video input and that goes into 
the radio, so the Raspberry Pi displays as Auxiliary 
Input. There’s two Auxiliary Outputs on the radio, 
so the Raspberry Pi sends a video to the main radio 
which then sends it back out to the screens in the 
passenger seats. What I’ve done 
is put in a device - like a VGA 
adaptor: it takes one input and 
puts seven out - that gives me 
the ability to have the Raspberry 
Pi running to the back screens 
on their own, so the radio can 
then control itself I can have 
my kids watching movies at 
the back with the Raspberry Pi 
using an audio splitter (they’ve 
got headphones on), and we can 
be at the front using the normal 
Above In this setup, the Pi is one of radio controls, like the satnav for 

the inputsfortheXtrons head unit example.Sothatworkswell.” 



Maker Profile 
Derek Knaggs 

Managing 

directar 

Derek Knaggs runs 
Flamelily IT, an IT 
supply and support 
company, and is 
studylngComputing 
atthe University 
of Worcester. 

Find out more: 

flamelily.co.uk 
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Now you're playing with power. Raspberry Pi power to 
be exact, situated inside on old game console 


_Q^ 

Chris Crowder 

Programmer and database administrator 

o 

Q_ 

Workinginthe car industry, Chris develops 


manufacturing systems for production floor 

o 

systems using .Net and SQL In his down time, he 


likes to play videogames and tabletop games, but 

(0 

was previously limited to his PC forthe former. 

Find out more: imgur.com/a/KPi2n?gaUery 


IS It was a little intimidating at first as 
I wanted to make sure that this project 
looked and felt like an NESH 


“It all started when my wife asked me what I 
wanted for Christmas”, said Chris over email. “I 

had absolutely no idea but I had been wanting to 
mess around with a Raspberry Pi since it came 
out, so she got me a starter kit. 

“While waiting for Christmas I started 
narrowing down ideas and found the RetroPi 
project. I thought that I would just install 
that, load some ROMs and call it good, then 
I remembered that I had some old NES and 
SNES controllers in storage. I went to get them 
and found my old childhood NES console along 
with the controllers. Once I got the NES back in 
the house and started looking at it, I found that 
almost all of the internals were damaged due 
to insects and moisture. All of the connectors 
were corroded and some of the boards had 



Above Everything is packed inside theoriginal 
case, without needingto open it up to use it 


traces that were peeling. That is when I 
decided that I would use the Raspberry Pi to 
‘resurrect’ the NES.” 

Chris completely gutted the case and 
replaced the insides with a Raspberry Pi, 
hooking up I/O ports to the original connectors 
for the controllers and the AV cables and such. 
What's it like taking on a project with one of the 
most revered consoles in videogame history? 

“It was a little intimidating at first as I wanted 
to make sure that this project looked and felt 
like an NES but with more flexibility. The biggest 
issue I ran into was that I wanted it to be able 
to work like an NES, meaning that if someone 
wants to play a game that they just turn it on, 
select a game and then they are playing. When 
they are finished all they have to do is press the 
power button to turn the console off. We can’t 
do that easily with a Raspberry Pi since there is 
no ATX-style power switch. I was able to solve 
this issue with a Mausberry Circuit and a Python 
script. When the power button is pressed it 
communicates with the Pi via a GPIO connection 
and it runs the shutdown command. Once the Pi 
is shut down, the circuit cuts the power to the Pi.” 

The final product works great, with Chris 
reporting he can play on Atari, Sega and 
Nintendo games just fine. He’s now looking to 
upgrade it with a Raspberry Pi 2 and increase 
the number of games hecan play. 


Refitting a NES 

Do you fancy taking on the challenge of 
bringing your old console back to gloriously 
pixelated life? Thought so. Inthatcase, 
you’ll be needingthis - here’s a list of the 
equipment that Chris used to repair and 
revive his childhood NES console: 

• A broken NES console - please don’tdo 
thisto a working console 

• Replacement NES Door 

• Canakit Starter B+ - soon to be replaced 
with a Raspberry Pi 2 

• Panel Mount Ethernet Cable 

• Panel Mount HDMI Cable 

• Panel Mount USB Cable 

• USB A Male Connectors lOpk 

• SNES USB Controllers 

• Anker 13000 mAh 3 watt Battery - this is 
for when there is no power outlet nearby 
or you want to be portable 

• Mausberry Circuit - shutdown circuit 
that uses your own switch, USB 

• LEGO -to hold the Mausberry Circuit 

• Gorilla Glue 

• Blue 3-volt LED - the original NES LED 
was 12 volts, plus all ofthe other items in 
Chris’ entertainment console are blue 





The Mission Control 
desk groups the 
various functions 
into ‘station’ panels j 


BO Jeff Highsmith 

Tinkerer extraordinaire 

Jeff Highsmith loves to make new and novel 
things. The medium isn’t important, and he 
enjoys scroungingformaterialsand making 
dowith what’s at hand. 

Find out more: jeffhighsmith.com 




Outside of 
playtime, this is 
just an ordinary 
homework desk. 
Almost 


Mission 
Conttx)! Desk 

Astronaut training begins 
early in Jeff Highsmith's 
home, with his sons running 
launches from their home- 
made Mission Control 


Asfrocarpentry 

The panels are assembled from bare 
components. Jeff ordered the switches and 
then designed the panel layout and labels 
on his computer, printing them on inkjet 
transparency - clear acetate - and then 
gluingthose onto some fibreboard that 
he had spray-painted a metallic grey. He 
esti mates that the whole budget was $700. 



Above These reflect the real stages of a NASA 
mission and play authentic recorded sounds 


Jeff Highsmith is probably the best Dad in 
the world. Not content to just build his son a 
desk for his room, he modified it so that space 
adventures can start with the push of a button. 

“My eldest son was starting kindergarten and 
he needed a desk to do his homework on,” Jeff 
tells us, “and since I like to build stuff I thought 
I would make him a desk rather than buy one, 
and I was thinking, ‘What would make a really 
awesome desk?’ Well, having lots of buttons and 
switches like a mission control desk! Carpentry- 
wise it was pretty simple to build. 

“The Raspberry Pi is up in the front-centre 
behind a piece of flexiglass, next to the Arduino 
that takes care of reading the inputs. The Pi 
handles all the sounds and the logic - the 
gameplay aspect. That was my first Python 
experience and it was pretty good. 

“The desk has got several modular panels 
and each has a different function. So in the 
real mission control at NASA there’s a desk 
that controls the retro stage, and for this desk I 
made a retro booster panel and put a bunch of 
rocket noises on it. There’s a capcom (capsule 
communicator) panel, so you put on a little 


headset and you can talk to the astronaut that is 
in the spaceship in the other room. 

“There are a couple of panels that have 
numerical displays: one reads out some attitude 
numbers, like x, y and z in space, and there's 
one that monitors the astronauts' vital signs 
(supposedly). There's one that does mechanical 
spaceship noises, like pumps, heating elements, 
buzzing noises, fans etc. I wanted it to be like 
you're turning things on and off, not just pushing 
a button that plays a sound - that's why i have 
the toggle switches as well as push buttons. 
There's a spot for the iPad in the middle too - you 
can watch videos of rocket launches. 

“There are homages to actual NASA 
emergencies, like the stirring of the oxygen 
tanks that led to the Apollo 13 explosion. I have 
a switch that makes it sound like it's stirring 
the tanks, then it makes an explosion sound 
and plays the audio from the astronauts 
talking: ‘Houston - we have a problem'. There's 
a sequence panel too that has the different 
mission stages on it and each of those plays a 
real NASA soundbite, all the way from the launch 
to the landing on the Moon to the splashdown.” 
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Spaceship Bedroom 

After successfully accomplishing his desk 
mission, Jeff Highsmith set his sights higher 


Mission control was but one small 
step. Next was the mission itself, 
as Jeff explains: “So my boys would 
hit the buttons on the desk and go 
through all those mission stages and 
run around with their toy rockets, but 
having the actual spaceship, I thought, 
would be cool. The spaceship has 
some panels similar to the desk, but 
it also has a small screen in there that 
goes to a video camera in the cargo 
bay. There’s a motorised hatch on the 
side that you can open up by flicking 
a switch, and then the camera shows 
you a cargo bay with a robot arm 
inside it. You can’t see the cargo bay 
when you’re inside because you’re 
laying on your back, but looking at the 
screen you can see it and the controls 
are in front of you. It really feels quite 
fun - I’ve got a little toy Hubble space 
telescope in there and I hung a piece of 
fishing line from the ceiling with a little 
bit of metal on it, and then I’ve got a 
magnet in the space telescope. So you 


take the telescope from the cargo bay 
with the arm, move it over and snap 
it onto the string that hangs from the 
ceiling - we call that orbit. Once it’s in 
orbit you can pull the arm back in the 
cargo bay, close the hatch and your 
mission is complete, you can return to 
Earth. And then there’s the inevitable 
mission to go and fix the Hubble... 

Jeff’s going to upgrade this 
awesome setup further. “Eventually,” 
he says, “I’ve got some ceiling satellites 
planned, so I’ll have them orbiting a 
track in one of the bedrooms and the 
iPad can monitor the different sensors 
on the satellites. The track will be a 
thin metal rod under the ceiling in an 
ellipse, and then each satellite will 
have a tiny wheel extending from the 
top of it, which has a very small gear 
motor on it, so it’ll hang from the track 
on that wheel. The idea is that the kids 
can build satellites out of Lego, put 
them in the cargo bay, then winch them 
up into orbit.” 



Above You can seethe robot 
arm reaching out of the cargo 
bay doorto the left 


Having an actual 
spaceship, I thought, 
would be coolf 


Aulomatic Roller 

Nearly a Rube Goldberg machine, we 
hope it plays ‘Powerhouse’ when used 

There are many schools of thought regarding your 
sleeping environment to help aid better and more 
restful sleep. No electronics in the bedroom, try and 
relax before going to sleep, take a cool or hot shower 
depending on the time of the year. Some people 
require pitch darkness to get a good night’s sleep 
though, while others like to wake up when the sun 
rises as part of a natural body reaction. Emil likes to 
do both of these things with his Raspberry Pi that 
automatically shuts and opens his blinds at specific 
times of day: 

“7:30: Press up button, wait 10 seconds (I have 
smaller windows on the bottom and bigger above 
them, so after these 10 seconds, shutters are going to 
be open only on the bottom ones), press stop button. 
8:00: Press up button. 22:00: Press down button.’’ 

Unfortunately, it means he has some electronics in 
his bedroom, but whatever works for him. 


Maker Profile 
Emil 

Jaworski 

Maker 

Findinghimselfina 
rented apartment 
for a few months, 
Emil has decided to 
upgrade it himself. 

Find out more: 

imgur.eom/a/ 

OYdPo 


RasPi Terminal 


We’ve had lots of Raspberry Pi over the 
years, but what about Apple Pi? 


Maker Profile 

Austen 

Barker 

Engineering 

student 

ACalifornian 
studentthathas 
a habit of messing 
around with any old 
computer hardware 
thathecangethis 
hands on. 

Find out more: 

imgur.eom/a/ 

vOsML 


“In my spare time I like messing around with older 
computer hardware that I come across. Originally 
I found the need for a terminal to connect over 
SSH to a server that I was using for an internship. It 
was more efficient than devoting a more powerful 
machine to it. I took a server to school with me to 
continue workingforthesame company as I studied. 

I had a Raspberry Pi also sitting around and I 
started hooking it up to a monitor from an Apple He 
that I found at my university’s electronics surplus. 
This became valuable when I started having to login 
to a school server over SSH to compile assignments 
for my programming classes. Eventually, I found a 
keyboard from a Macintosh 512k and made it work 
over USB with a microcontroller and a custom wired 
key matrix, and I paired it with the monitor and Pi.’’ 
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Alarm Dock Robot 


Chasing your alarm clock may sound like o 
nightmare to some, but here it is in reality 


Robotics education 

There are many ways to get kids excited 
with coding, like making games in Scratch, 
modifying Minecraftand teaching via 
robotics. The latter is a new concept but 
stiil has the same merits - a physical 
creation that children are excited about and 
react to the programming they’ve done on 
it. Visible results and instant gratification is 
a great way to get imaginations fired up. 


When we talked about Roily the alarm clock 
robot around the office, most people burst 
forth with a string of expletives not fit for print. 

It’s a delightfully evil invention - an alarm clock 
you need to work for to turn off. It sounds like a 
great invention, getting people who have trouble 
waking up to actually get up out of bed and start 
the morning. 

Like any other Dexter Industries robot, it runs 
on BrickPi, the LEGO Mindstorms adapter for 
the Raspberry Pi that enables it to interface with 
LEGO kits via programming. 

“Today almost everyone uses their phone as 
an alarm clock, which has a range of benefits,” 
the website explains. “Phones are easy to 
set, easy to adjust, play custom songs and 
can even sense when is the best time to wake 
you up. The problem is, unless your phone is 
across the room, we use our phones so much 
we can literally use them in our sleep. Why not 
build a robot that is able to do all these things, 


™ Taryn Sullivan 

Advisor 

IbB Taryn is an international businesswoman. As well 
as flying between Shanghai and DC for her own 
engineering business, she now works with Dexter 
Industries to promote robotics education. 

Find out more: bit.iy/iBTYijv 


but won’t stop till you get up and start moving! 
Our robot will be able to easily move randomly 
around the room over any surface, playing a 
custom alarm tone. 

“In order to set the alarm, simply link the 
program on the BrickPi to your Google account 
and it will search events with the title ‘wakel’ 
and automatically start the alarm at the event’s 
time. This means the alarm time can very easily 
be adjusted using any device that can access 
your Google Calender.” 


PiFM Radio 

Sometimes the simplest hacks can 

open up whole worlds of possibility 

Maker Profile 

When studying at Imperial College London, 

Oskar Weigl 

Oskar Weigl and Oliver Mattos turned the Pi 

into an FM radio by connectinga wire (antenna) 

Electronics 

to GPIO 4 and usinga custom Python module. 

engineer 

“There is a clock generation module in the 

Oskar is an 

hardware of the Raspberry Pi chip that lets 

electronics 

you output a clock signal at a user-selected 

professional and 

frequency,” Oskar explains. “We used the DMA 

hobbyist, as well as 

controller to send commands to the clock 

an avid forward 

module to change the frequency and achieve 

and reverse 
engineer. 

frequency modulation. We had to overclock 
the clock generation module by a factor of 20. 

Find out more: 

The sound is 14 bits per sample, enhanced to 

bit.ly/1om6BQE 

a higher number using delta sigma modulation 

k 

and the range is at least 50 metres.” 

4 


Ras Pi Smart TV 

Is your snnart TV not smart enough? 

Open the case and put a Pi inside 

“There’s plenty of room for additional electronics 
inside the Hisense LED smart TV,” begins Tony 
Hoang. “There’s a large flat area for electronic parts 
in the centre of the TV where I placed my Raspberry 
Pi. The dual down-facing speakers were quite loud, 
so I removed one and replaced it with a USB hub. The 
back panel was mostly flat, so finding a spot for the 
LAN port and HDMI output wasn’ttoo hard. 

“The Raspberry Pi is powered by the logic board 
of the Hisense. There were the obvious 5v-500 mAh 
outputs from the 2x USB 2.0 ports, which I tried but 
I found out that the logic board shuts off the power 
to these ports when the TV turns off. To keep the 
Raspberry Pi turned on, I probed the logic board with 
a multimeter and found onefrom an unused GPIO.” 


Maker Profile 
Tony Hoang 

Graduate 

researcher 

Tony Hoang is a PhD 
student studying 
computational 
biophysics and 
single molecule 
research atSUNY- 
Albany in Albany. 

Find out more: 

linkedin.com/in/ 

tonyphoang 
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Astrogun 

An augnnented reality light gun ganne 


Walking around Maker Faire, you see some 
weird and wonderful things. If you’d been 
present at the Jerusalem Maker Faire you 
may have seen people wield a giant toy gun to 
shoot down virtual asteroids in Avishay’s AR 
motion game Astrogun. 

“In the Astrogun lies a Raspberry Pi 
computer,” Avishay explains. “An IMU card 
connected to it (Sparkfun’s MPU-9150 
breakout board) gives it the ability to sense 
the unit's orientation. The Pi is then able to 
draw the elements seen from that angle. 


When the player moves, the graphics move, 
givingthe ‘object in the room’ sense.” 

Why the Raspberry Pi? It was due to time, 
according to Avishay: “I had a short time to 
bring it to a working thing, so I had to pick a 
platform that was capable of the task and 
easy to use. The RPi fits that criteria. I used 
many software components designed for the 
RPi or tested on it - the Pi3D and RTIMULib. 
The combination of Pi as a hardware platform 
and Python as a programming language is 
the fastest way to materialise ideas.” 


Maker Profile 


Avishay 

Orpaz 

Electronics 

engineer 

Find out more: 

bit.ly/1AYPSqg 



Pirate TV 


#rl>nv 

di ■ 



' A U/ 


«■ t a 


Go all the way and totally rebuild Android TV! 


a ; 
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Maker Profile 

Donald Derek 
Haddad 

Software 

engineer 

Donald is an open 
source hacker. 

Find out more: 

donaldderek.com 


The perfect companion to the Smart TV 
hack, Donald Derek Haddad’s project is a 
custom TV interface you can make yourself. 

“Pirate TV is a smart television 
application that runs on the Raspberry 
Pi with the Raspbian OS,” Donald tells 
us. “It’s built with open source tools and 
shipped with a free remote controller, 
your mobile device. At its core lies a Node, 
js application that runs a web server with 
Express.js/Socket.io to handle users 


requests from the remote and trigger shell 
scripts. The TV user interface is rendered 
on a Chromium instance in kiosk mode. 
Videos are streamed from YouTube or other 
channels played on OMXPlayer, and cached 
including 1080P FID content. This project is 
a work in progress and it’s not going to be 
able to tap into a lot of the content, which 
makes a Google (now Android) TV or other 
commercial platforms so valuable.” Check 
out Derek’s tutorial: bit.ly/1l6YKpj. 


Pye Radio 

Old meets new in this modified radio 

Upcycling is a great concept: recycling a 
product using new technology to make 
it relevant in the modern world. While 
standard analogue radio isn’t dead yet, its 
nice to have options when listening to music. 
This is where Tony’s idea came in: 

“I’d been working on a Raspberry Pi to play 
music streams through my stereo. Cnee this 
was running I integrated the Raspberry Pi into 
an old radio named a Pye! With a background 
in woodwork and engineering this seemed 
like the perfect project.” 


Maker Profile 
Tony Flynn 

Senior embedded 
systems design 
engineer 

Find out more: 

bit.ly/19zrgPl 


Flowever, this project wasn’t a walk in 
the park for Tony: “The hardest part of the 
oonversion is linking the tuner knob to the 
rotary encoder. For this radio I used the 
spring from an old biro as a drive train to link 
the tuner knob spindle to the rotary encoder 
through 90 degrees.” 

Did Tony have qualms about heavily 
modifying such a classic design? “None 
whatsoever! Some people don’t like the 
modern style now stamped on this old radio, 

I think it’s anew era, new look!” 
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Digital 

Qimera 

Conversion 

Classic aesthetics with modem 
convenience, this old-school 
camera has been upgraded 
with a Raspberry Pi 


_Q) 

Pete Taylor 

Web manager 

o 

Q_ 

Pete works fora charity and has always tinkered 


with computers, ever since he got a hand-me- 

a> 

down BBC computer. He likes thatthe Raspberry 


Pi returns to a time when you could hack your own 

(0 

computer without makingan expensive mistake. 

Find out more: bit.iy/iMKRASw 


■8 The Raspberry Pi is 
a maker’s dream - it’s 
cheap and cheerful, 
and the community 
built around it is a 
brilliant resource H 


Old cameras have a very specific design 
aesthetic that it seems has been lost to 
time, although nostalgia for them is still very 
strong in certain circles. Unfortunately, while 
nostalgia, desire and working cameras still 
exist in the 21st Century, usable film is quickly 
dwindling in supply. So if you like the aesthetic 
and aren’t too bothered about using the old 
photo process, why not upgrade the insides 
with more modern technology? 

“I wanted a suitable case for the Raspberry 
Pi camera board,” Pete tells us, “and the Holga 
seemed a perfect fit. Most of the available 
cases are either a bit ugly or suited more 
towards stationary webcam-type applications.” 

Why the Raspberry Pi, though? 

“The Raspberry Pi is a maker's dream - 
it’s cheap and cheerful, and the community 
that’s built up around the Pi makes a brilliant 
resource when you’re stuck with a problem or 
want to find out more.” 

The entire build doesn’t require a massive 
amount of components either. As well as 


the actual camera and Pi itself, Pete used a 
Raspberry Pi camera board to actually take 
photos, a Wi-Fi module for connecting to it 
remotely, a battery and a switch for it, and 
a few buttons and resistors to wire up the 
camera’s control buttons to the Pi. 

“It works better than I expected!” Pete said 
about the quality of the finished product. 
“Although it seems a bit daft to build a camera 
that’s about as good as you’d get from a cheap 
camera phone, it’s changed the way I take 
pictures. By removing the instant replay - most 
people seem to view the world through the 
displays on their phones - I can concentrate on 
taking the photo. Only seeing the pictures when 
I’ve taken the camera home and downloaded 
them to my PC adds a bit to the film nostalgia 
and I’m often surprised by the photos I’ve 
taken. Plus I’ve received some nice feedback 
about how the camera looks.” 

This is only the first iteration, and Pete has 
plans to make the next build easier and also 
use the original lens with the Pi camera. 


Do it yourself 

Version two of the project will result in a kit 
that people can use to convert their own 
cameras “that doesn’t require you to take 
a Dremeltothe insides of a Holga!”. He’s 
not decided yet on whether to make a kit 
that converts a Holga, or a kit that builds a 
Holga-esque case around the Raspberry 
Pi itself. Either way, the whole thing should 
also have a better photo-taking capability, 
which is the ultimate goal. 



Top-left The 

camera of the 
past, updated 
fortoday 

Left The Pi is 
the perfect size 
to fit inside the 
camera case 
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BHcoin Pool Table 

Modern pool pros pay digitally by 
scanning a QR code to insert Bitcoins 


Maker Profile 
Stuart Kerr 

Technical 

director 

Stuart Kerr is the 
technicaldirector 
of Liberty Games, 
which specialises in 
classic table and bar 
games. You might 
have heard of some 
of their hacks. 

Find out more: 

libertygames.co.uk 


Liberty Games loaded a Raspberry Pi into the side of 
a pool table that enables people to make payments 
viaa Bitcoin app on their phone to release the balls. 

“We did this with the Raspberry Pi 1”, Stuart tells 
us. “We tried to install the entire Bitcoin client on 
the Pi but it was struggling, and downloading the 
whole blockchain caused issues too. It was going to 
be oonneoted to the Internet, so we offloaded the 
heavier work to a server able to handle the blockchain. 
The server receives the Bitcoin payment and then 
communicates to the Pi securely that the payment 
has come in, and it syncs up the prices as well. 

“We connected a PiFace via a breakout board 
that’s monitoring on WebRCT for the go-ahead from 
the server, and once it gets that, it sends the physical 
voltage to the electrical ball release mechanism 



Above The price of a game is displayed, in 
Bitcoins, on the PiFace display module 



Fireball Pinball 

Ian Cole and his sons enter the high 
score boards with Rreball HD 


Maker Profile 
Ian Cole 

Maker and 
geek raiser 

Ian Cole is a keen 
maker, hacker 
and inventor, and 
regularly blogs 
about his family 
projects with his two 
sons.TheirFireball 
project, for example, 
grew out of an 
innocent ‘Can you 
make it playable?’ 

Find out more: 

raisinggeeks.com 


At raisinggeeks.com, Ian Cole and his two sons 
love a challenge. So the chance to repair a game 
table gave them the perfect Raspberry Pi primer. 

“We've taken an existing pinball machine 
playfield,’’ says Ian, “and built a new game from 
it. This required learning the underlying hardware 
first. Then we learned how to use the Raspberry Pi, 
pygame for sound and text graphics, and omxplayer 
for HD video, and we connected the software tools 
with the hardware of the pinball machine. 

“We built a MOSFET circuit on a breadboard 
to test a single solenoid. When that worked, we 
duplicated it onto a hand-soldered protoboard 
and extended it to control the five solenoids. The 
Raspberry Pi handles graphics, audio, scoring rules, 
saving scores, etc. One Arduino drives the lamp and 
switch matrix, another drives the solenoids. The 
three are connected with an I2C bus.” 


V. 
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LED Voice-Controlled Coffee Table 

Light up your living room with a voice-controlled light show for a coffee table 


Maker Profile 
MikelDuke 

Software 

developer 

Mikel loves 
programming, 
photography, biking 
and hiking, and 
sharinghis projects. 

Find out more: 

bit.ly/IFOHDkW 


Mikel found himself in a quandary: he 
didn’t have a coffee table. However, 
instead of just heading to Ikea and 
picking up a LACK, he decided to 
make one himself. Not just any coffee 
table though, one that lit up using a 
Raspberry Pi to controlthe sequence. 

“I used the Raspberry Pi because it 
was easy to work with and has a great 
community. Whenever I run into an 
issue, there is always documentation 
on how to fix it. I wanted to have 


network support and do more complex 
operations, like loading images, than 
I could do just using an Arduino with 
Ethernet. The combination of the 
two really made development faster. 
Now that Pi4J has added support for 
the Raspberry Pi’s integrated SPI, I 
am working on controlling the LEDs 
directly, without the Arduino.” 

Recently, Mikel added voice control 
to it using Google Now. “After you say 
a command to Google Now, Autovoice, 


a plugin for the Android app Tasker, 
intercepts the response back from 
Google. If the response matches a 
Tasker task, the task will be launched. 
I have a few tasks set up to make web 
service calls, basically calling a URL 
with parameters. This URL connects 
to a Java based web service I created, 
running on my Raspberry Pi.” 

Mikel also encourages users not to 
use coasters, as drinks light up well 
when the table is switched on. 
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Above Alarm 
mode can only 
be disabled with 
the right finger or 
the master code 


Project Jarvis 

The 1950s future today with your 
voice-activated smart home 
automation system 


_Q) 

— 

Mayur Singh 

Computer systems engineering student 

O 

Q_ 

Located in South Africa, Mayor’s expertise is 


in embedded systems and he is familiar with 

a> 

microcontrollers and systems that enable 


outside hardware interaction, such as the 

(0 

Raspberry Pi and the Beaglebone Black. 

Find out more: bit.iy/iEvimci 


Home automation has been a thing for years 
now, with a fair few intrepid engineers and 
DIYers modifying their home. With wirelessly 
controlled lights, heating, garage doors and 
many other household items, it’s amazing what 
some have achieved. Science fiction has always 
portrayed houses with advanced systems and 
Mayur has been busy creating such a system. 

“The major inspiration came from watching 
the Iron Man movies, which is where the name 
Jarvis comes from, i decided to build a simple 
home automation system, however over the 
many years and many reinstalls of Windows, 
i lost my program, i built a new and improved 
home automation system, which features an Ai 
assistant and more functionality, after i sawthe 
third Iron Manfilm.” 

While home automation is one part of the 
project, convenience isn’t the only factor. 

“The main function of the system is to 
help save energy in homes,’’ Mayur tells us. 
“Jarvis can read and monitor the electricity 

HThe Raspberry Pi is 
a maker’s dream - it’s 
cheap and cheerful, 
and the community 
built around it is a 
brilliant resource B1 



Left The Jarvis 
interface is 
gorgeous, but 
you oan control 
the system from 
anywhere using 
your smartphone 
oryourvoice 


usage per light or appliance and this lets the 
Ai perform certain tasks. These tasks are 
determined by outside factors, like whether 
or not a light should be switched on if there 
is adequate natural light in the room. This is 
a basio example but other factors influence 
the determination of the AI, which has control 
over the power to each light or appliance. The 
data is logged throughout the month and the 
system uses that information to achieve better 
results the following month. This is smart 
home automation.’’ 

The Jarvis AI is a major part of it, and you can 
talk to it. “He can control your home usingvoice 
interaction and make basic decisions about 
energy savings in a room, i have also recently 
built a wall-mounted tablet system that links 
to a local online grocery store. It uses voice 
control to identify what products you need and 
adds the items to a list until you specify the 
delivery.’’ 

With a year and a half of work on the project, 
everything Mayur has completed works 
reliably, but there are still more functions he 
wants to add. 


The voice 

The Jarvis that this project is named after 
is well-known for its snarky remarks and 
tone of voice. Choosing an actual voice that 
works though is a hard enough task without 
going for a certain style, as Mayur explains: 
“It’s been difficulttryingtofind voices with 
a good API and price but I have settled for a 
free API which offers cloud conversion and 
just sends an MP3 sound file back. It takes 
longer but it ensures that the voice works 
on allOSs.” 

If you’re interested in having a go at creating 
your own Jarvis-esque home automation 
system then thankfully you’re in luck. You 
can check out Joey Bernard’s extensive 
three-part series (beginning on page 76 of 
this very book) that explains how to set up 
a digital assistant that uses Pyaudio and a 
few voice recognition modules in orderto 
parse your spoken commands. 
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Portable 
Pi Arcade 



Love old arcade gomes? 

With Ben HecKs hocK you con ploy them all 
on 0 single hand-built hand-held console 


Ben Heck has built two versions of the 
Portable Pi Arcade. The first was the original 
Portable Raspberry Pi project (youtube.com/ 
watch?v=dUZjzQuTNX4), where he hacked the 
Pi to reduce its size and opened up a USB game 
controller to extract the circuits. With a new 
assembly in place, he 3D-printed a custom- 
designed case, put the new device together, and 
booted up MAME (the Multiple Arcade Machine 
Emulator) to play old-school games. 

His recent revival of this earlier project was 
even more home-made. Eor the Raspberry Pi 
MAME portable gaming device (youtube.com/ 
watch?v=zrEj1aQRbpw), Ben made a circuit 
board from scratch, fitting all the components 
into a new SD-printed case that, rather than 
resembling a Game Gear, looks pretty close to 
a Game Boy. 



Above Watch the video to see how Ben build 
and tests the custom circu it board 


We asked Ben to take us through the original 
version of his project: “My first portable Pi project 
was a small, battery-powered unit for gaming,” 
he begins. “It had a single USB port for Wi-Ei 
or external storage and we featured it back on 
season three of the show. The screen came from 
a cheap NTSC LCD screen that Amazon sells 
for use as a car’s backup camera. The buttons I 
laser-cut myself and the case was 3D-printed.” 
And in terms of physical modifications to the 
Pi? “Mostly I removed the taller through-hole 
components,” he replies, “and attached the 
Teensy HID (used for controllers) directly to it. I 
also moved the secondary USB port.” 

As you can see above, the case is very well 
made. “I did the initial layout in Adobe Illustrator, 
for the laser-cut portions,” explains Ben, “then 
transferred the whole design to Autodesk 123D 
to create a 3D-printable file. Hand-writing 
the buttons for the controls was the most 
challenging part of this project. It was the 
most time-intensive part and required a lot of 
precision and attention to detail.” 

Ben is no stranger to taking apart consoles 
and controllers for his Pi hacks - but he also 
makes one-handed accessibility controllers. “In 
addition to all of the other projects and hacks, 
we modify gaming controllers for people who 
have difficulty using existing ones,” Ben tells 
us. “On the show we’ve featured a few of them 
- Xbox One, PSA, even the Wii. Now we build 
these controllers by request and they can be 
ordered off my website, though we only do Xbox 
360/Xbox One controllers as those use PCBs 
throughout (instead of silk screen circuits like 
the PSA). Recently I trained Felix (an assistant on 
elementlA’s The Ben Heck Show) on how to do it, 
so he’s been helping and working on them in his 
spare time as well.” 
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Ben Heck is an online sensation and a pillar of 
the maker community, putting out amazing 
how-to videos for games console hacks and all 
kinds ofdifferent Pi projects. He’s done it all on 
The Ben Heck Show. 

Find out more: benheck.com 


Heck's hacks 

Pi Point and Shoot: A Raspberry Pi camera 
module, PiTFT from Adafruit, PlayStation 3 
controller battery and additional parts were 
all made into a point-and-shoot camera. 

Pi Retro Computer: A tribute to the BBC 
Microcomputer from the 1980s, Ben 
mounted a Raspberry Pi to a self-made 
wooden case, HDMI port, on/off switch and 
USB hub for an ‘old-school’ feel computer 
and carrying case. 

Handheld Pi Console: Ben hacked a 
Raspberry Pi single board computer 
to make it smaller. Combined with a 
composite LCD wireless keyboard, lithium 
battery power source and USB joystick, he 
created a handheld gaming console. 
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